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INTRODUCTION 

It  is  important  to  note  that  the  engineering  design,  procurement 
test  and  meteorological  application  of  results  of  this  research  have 
recieved  national  and  international  acclaim.  Hundreds  of  scientists 
and  engineers  have  personally  visited  the  Colorado  State  University 
specifically  to  view,  discuss  and  carryaway  information  about  the  re¬ 
sults  of  the  research  on"ADVISAR". 

The  research  that  was  performed  consisted  of: 

1.  Design  and  development  of  a  prototype  digital  image  refresh 
system  for  use  with  quantitative  satellite  research  and 
application. 

2.  Design  and  development  of  a  mini-computer  interface  suitable 
for  a  field  refresh  unit. 

3.  Development  and  integration  of  software  in  the  meteorological 
applications  area. 

4.  Use  of  the  new  systems  to  carryout  satellite/weather /radar 
research  on  clouds. 

As  a  direct  result  of  the  research,  several  scientific  papers  and 
presentations  were  completed.  These  are  catalogued  in  Appendix  A.  Also 
several  reports  describing  the  hardware  have  been  developed  and  these  are 
referred  to  where  needed.  Each  of  the  above  categories  is  discussed  in 
detail  below. 

1.  Prototype  Digital  Image  Refresh  System 

The  digital  imaging  system  named  ADVISAR  (All  Digital  Video  ^Imaging 
System  for  Atmospheric  Research)  was  designed  during  the  first  phase  of 
the  work.  The  design  was  then  subcontracted  to  INTEL  Corporation  for 
construction  and  the  system  was  on-line  during  the  summer  of  1977.  This 
phase  of  work  was  funded  in  part  by  Colorado  State  University  as  a 
matching  effort  and  demonstrated  cooperation  with  various  research  groups 
and  industry  to  develop  a  state  of  the  art  tool  for  meteorological 
research. 

The  ADVISAR  system  consists  of  eight  frames  of  solid  state  memory 
with  each  frame  consisting  of  512  x  512  -  8  bit  pixels.  In  the  initial 
phase  the  system  was  run  under  control  of  an  HP-2100  computer.  Since 
then  the  control  has  been  transferred  to  a  DEC  PDP-11/60  as  described  in 
the  next  section.  The  most  important  feature  of  ADVISAR  is  its  capa¬ 
bility  to  rapidly  display  eight  images  therby  allowing  the  meteorologist 
to  visualize  the  temporal  aspects  of  satellite  images.  A  detailed  des¬ 
cription  of  the  system  has  been  published  and  the  report  is  included  in 
Appendix  B. 
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After  completion  of  ADVISAR,  the  acquiring  of  good  quality  satellite 
data  began  to  be  a  problem.  We  recognized  that  if  we  were  to  do  long 
term  research,  a  groudstation  at  CSU  would  be  necessary.  This  goal  has 
now  been  achieved.  We  have  today  a  total  acquisition  and  display  system 
centered  on  the  concept  of  using  a  man-in-the-loop  to  guide  the  processing 
and  display  of  the  meteorological  imagery.  The  system  software  provides 
the  user  with  the  ability  to  effectively  use  the  system.  This  is  des¬ 
cribed  in  greater  detail  in  Section  3. 

At  this  time  there  are  a  variety  of  vendors  who  market  image  systems 
and  further  development  work  in  the  university  is  not  needed.  These 
systems  have  evolved  because  of  inexpensive  solid-state  memory.  However, 
the  total  systems  aspects  of  meteorological  image  processing  still  needs 
work  if  modern  integrated  circuit  technology  is  to  be  incorporated  into 
further  applications. 


2.  New  ADVISAR  Interface 

During  the  last  phase  of  the  project  a  new  interface  to  the  DEC 
PDP-11/60  computer  was  designed,  constructed  and  placed  into  operation. 
This  has  allowed  the  ADVISAR  system  to  be  controlled  by  the  latest 
generation  of  mini-computers  thus  providing  vastly  improved  capability. 
With  the  groundstation,  the  total  system  configuration  now  appears 
as  shown  in  Figure  1. 

A  custom  interface,  based  on  a  modified  general  purpose  DMA  (Direct 
Memory  Access)  foundation  module,  now  connects  CSU's  ADVISAR  memory 
system  to  the  DRSGS  (Direct  Readout  Satellite  Ground  Station)  PDP-11/60 
UNIBUS  (Figure  2).  In  addition  to  the  DMA  module,  the  interface  includes 
user  logic  assembled  on  a  seperate  quad  wire  wrap  card.  Zvi  Barak  de¬ 
signed  and  assembled  user  logic;  for  detals  see  Appendix  C. 

From  Figure  3,  fixed  logic  on  the  DMA  foundation  module  includes 
UNIBUS  drivers  and  receivers,  an  address  decoder,  four  registers  (input 
data,  output  data,  word  count  (WCR) ,  and  the  bus  address  (BAR),  a  multi¬ 
plexer  for  selecting  and  gating  register  information  onto  the  UNIBUS, 
interrupt  logic,  and  a  bus-master  controller.  Several  modifications 
enhance  capabilities  of  the  DMA  module:  additional  logic  permits  byte 
oriented  (rather  than  standard  work  oriented)  data  transfers  between 
interface  and  peripheral  device;  expanded  address  decoding  supports 
an  off-board  command  channel  buffer  register;  and  a  WCR  all-ones  detector 
controls  DMA  data  transfer  completion. 

Figure  4  presents,  in  block  diagram  form,  wire  wrapped  ADVISAR 
interface  user  logic.  Board  components  include  a  control  and  status 
register  (CSR) ,  a  command  channel  buffer  register,  an  output  data 
control  logic  for  communications,  with  the  modified  DMA  module  and 
ADVISAR.  Users  establish  ADVISAR  system  staus  via  commands  sent  over 
control  channel  lines  CBITOO  -  CBIT15;  pulse  DCCC  initiates  command 
transfer.  To  prevent  flickering  or  flashing  images,  some  command 
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transfers  take  place  during  verticle  blanking  periods  only  (N  Imsec 
every  1/60  second);  CCFLAG  generates  an  11/60  interrupt  whenever 
ADVISAR  videotiming  signals  initiate  display  monitor  vertical  retrace 
operations.  After  establishing  proper  status,  the  interface  controls 
transfer  of  data  bytes  either  to  (WEA11  -  WDA07)  or  from  (RDA00  -  RDA07) 
ADVISAR  image  or  enhancement  table  memory.  Timing  pulse  DCDC  initiates 
data  transfer  and,  subsequently,  DCFLAG  signal  transfer  completion. 

The  detailed  design  is  given  in  Appendix  C. 


3.  Software  Development  for  Meteorological  Application 

The  software  is  the  product  that  interfaces  the  systen  and  the 
user.  Recognizing  that  the  data  collection  and  ADVISAR  systems  would 
be  used  by  a  variety  of  users  having  computer  skills  ranging  from  none 
to  good,  a  keyed  system  design  was  chosen.  The  system  had  to  be  modular 
so  that  new  applications  software  could  be  easily  inserted  while  main¬ 
taining  system  integrity  and  operation.  Man/machine  communication  had 
to  be  easy  and  therefore  included  the  use  of  well  designed  cursors  to 
simplify  the  location  of  specific  regions  of  a  given  image. 

Once  achieved,  this  resulted  in  a  variety  of  scientific  products. 
Seperate  radar  and  satellite  observations  were  composited  on  the  ADVISAR 
to  monitor  convective  development,  the  organization  of  mesoscale  features 
with  respect  to  the  synoptic  scale,  severe  storm  signatures  and  convec¬ 
tive  and  stratiform  precipitation  during  the  fields  program  of  the  bureau 
of  Reclamation's  High  Plains  Experiment  (HIPLEX) . 

Extensive  documetation  of  the  computer  software  is  provided  in 
Appendix  D. 


4.  Summary  of  Meteorological  Research  Accomplishments  Using  the 
ADVISAR  (All  Digital  Vedeo  Imaging  System  for  Atmospheric 
Research) 

Smith  and  Reynolds,  1978,  have  developed  procedures  whereby  re¬ 
motely  sensed  radar  and  satellite  observations  can  be  composited  in 
common  map  projections  and  displayed  using  an  interactive  image  pro¬ 
cessing  system  (ADVISAR)  which  uses  high  fidelity  video  display  tech¬ 
nology. 

The  5  cm  SWR-75  digital  radar  data  and  GOES-East  visible  satellite 
data  are  prepared  separately  and  stored  in  the  digital  video  refresh 
memories  of  ADVISAR.  The  two  separate  memories  are  then  composited  on 
the  color  television  monitor  using  seperate  color  input  channels.  As 
the  magnitudes  and  respective  ratios  of  the  digital  equivalence  function 
values  for  the  radar  dbz  and  satellite  visible  intensity  vary  the  cor¬ 
responding  color  enhancement  signatures  change.  Using  this  same  tech¬ 
nique  a  third  channel,  the  infrared,  has  been  added  to  the  compositing 
scheme. 
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The  digitally  based  compositing  technique  provides  a  significant 
improvement  over  conventionally  presented  radar  and  satellite  data  by 
reducing  the  amount  of  information  needed  to  be  assimilated  by  the 
forecaster.  More  importantly  it  provides  an  immediate  focus  to  the 
forecaster  with  respect  to  the  satellite  information.  Since  the  radar 
data  alerts  a  forecaster  to  the  potential  for  severe  weather,  the 
satellite  observed  growth  processes  available  to  the  forecaster  with 
this  technique  can  now  be  monitored  directly  in  conjuction  with  echo 
growth.  This  will  allow  the  forecaster  to  concentrate  on  the  actual 
developing  weather  phenomena  rather  than  the  mechanics  of  orientation. 
Ultimately  it  is  hoped  that  a  standardized  forecast  product  using  radar- 
satellite  composites  will  be  developed. 

Reynolds  and  Morris,  1978,  have  demonstrated  the  usefulness  of  the 
ADVISAR  system  in  the  analysis  of  digital  satellite  data  for  operational 
seed,  no  seed  decision  making  with  regard  to  cold  orographic  clouds  set 
up  by  the  Sierra  Nevada  mountain  barrier  in  East-central  California. 

In  support  of  the  Sierra  Cooperative  Program  of  the  Water  and  Power 
Service  they  examined  digital  infrared  imagery  for  several  case  study 
days  to  determine  cloud  top  temperatures  over  the  Sierra  Program  target 
region. 

Previous  research  has  shown  that  the  cloud's  top  temperature  is 
related  to  its  seedability.  Specifically,  clouds  with  teperatures 
between  10  to  25°C  have  deficient  ice  nuclei  for  efficient  precipitation 
and  therefore  such  clouds,  if  seeded,  could  increase  their  potential 
precipitation  significantly. 

The  usefulness  of  the  digital  satellite  imagery  displayed  on  the 
ADVISAR  system  lies  in  its  ability  to  sense  and  graphically  display 
area-averaged  cloud  top  temperatures  at  short  time  intervals.  This 
area-averaged  temperature  may  give  a  more  representative  value  of  cloud 
top  temperature  than  the  point  value  obtained  from  a  sounding  due  to  the 
displacement  of  the  sounding  from  the  area  of  interest  and  the  spatial 
variation  of  cloud  tops  where  embedded  convection  may  exist. 

The  case  studies  examined  revealed  a  good  comparison  between  satel- 
lite/ADVISAR  derived  temperatures  and  cloud  truth  data  acquired  from 
aircraft.  These  results  have  allowed  CSU,  with  its  Direct  Readout 
Satellite  Ground  Station,  to  initiate  real-time  satellite  support  for 
decision  making  purposes  during  subsequent  Sierra  Cooperative  Program 
field  seasons. 

Reynolds,  1978,  has  used  the  ADVISAR  to  make  rainfall  estimates 
over  a  low  density  rain  gauge  network  of  the  Water  and  Power  Services 
HIPLEX  (High  Plains  Experiment)  field  site  near  Miles  City,  Montana. 

This  study  was  similar  in  nature  to  that  by  Smith  and  Reynolds,  1978, 
except  that  in  addition  to  digital  radar  and  digital  geosynchronous 
satellite  data  to  estimate  cloud  heights  and  temperatures,  data  Trom 
a  high  density  rain  gauge  network  at  the  core  of  the  field  site  was  also 
used  in  making  estimates  of  precipitation  in  the  much  larger  low  den- 


5 


sity  rain  gauge  network  surrounding  the  core  area. 

Results  of  the  study  showed  that  digital  satellite  data  compared 
favorably  with  the  radar  and  rain  gauge  data.  A  bi-spectral  approach 
showed  possibilities  for  determining  rain-no  rain  events  but  did  not 
appear  to  quantify  the  rain  aramounts.  Having  digital  data  available 
in  the  ADVISAR  system  allowed  mathematical  transformations  of  each 
spectral  data  set  as  well  as  a  combination  of  the  visible  and  infrared 
data  into  a  single  bi-spectral  image.  A  preliminary  technique  was 
tested,  inverting  the  IR  data  [i.e.  cold- low  count,  warm-high  count 
(as  it  would  be  truly  sensed  by  the  detector)]  and  subtracting  it  from 
the  visible  data.  This  resulted  in  a  bi-spectral  image  whose  values 
can  be  monitored  with  time  to  determine  a  relationship  to  rainfall. 

A  few  further  results  showed  that  the  infrared  data,  although 
underestimating  the  maximum  cloud  radar  height,  did  show  the  relative 
changes  in  top  height  which  related  well  to  rainfall  at  the  surface. 
Maximum  rainfall  appears  to  occur  before  the  coldest  cloud-top  tem¬ 
perature  is  reached.  Vertical  wind  shear  appears  to  be  important  in 
determining  rainfall  efficiency  and  should  be  considered  in  a  satel¬ 
lite  rainfall  method.  The  visible  reflected  brightness  is  an  earlier 
indicator  of  rainfall,  although  its  magnitude  is  affected  strongly  by 
geometric  factors  that  must  be  accounted  for  before  a  bi-spectral  rain¬ 
fall  study  can  be  performed. 

Finally,  Reynolds,  Brown,  Smith  and  Vonder  Haar,  1978,  used  ADVISAR 
in  studying  cloud  type  separation  by  spectral  differencing  of  image 
pairs.  The  raw  infrared  and  visible  counts  were  normalized  to  an  8-bit 
scale  (0-255)  but  were  not  converted  to  radiometrically  linear  units. 

The  difference  image  was  also  rescaled  to  the  0-255  range.  Therefore 
all  three  images  (infrared,  visible,  difference)  utilized  the  complete 
dynamic  range  of  the  ADVISAR  video  refresh  memories.  Clouds  that  were 
cold  and  bright  (high  IR  count,  high  VIS  count)  produced  a  difference 
signature  in  the  gray  or  medium  values.  Cold  and  dim  regions  (high  IR 
count,  low  VIS  count)  appeared  as  the  very  lowest  values  in  the  dif¬ 
ference  image,  or  black.  By  adding  image  sequencing  to  the  procedure 
it  was  possible  to  remove  any  remaining  ambiguities  in  the  separation 
of  clouds  from  snowfields.  Simple  subtraction  of  images  using  objective, 
quantitative  threshold  values  resulted  in  a  technique  to  identify  cirrus 
clouds. 

[See  Appendix  A  for  a  bibliography  of  additional  scientific  reports 
and  publications  sponsered  by  this  research  grant.] 


FIGURE  I.  PRESENT  SYSTEM  BLOCK  DIAGRAM 


Figure  2.  ADVISAR  Interface 
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Figure  3.  Modified  General  Purpose  DMA  Foundation  Module 
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PREFACE 


The  system  described  hereby  was  designed  for  replacement  of  a  simi¬ 
lar  existing  unit,  which  is  now  employed  by  the  ADVISAR  (All  Digital 
Video  Imaging  System  for  Atmospheric  Research),  a  system  which  is  now  in 
use  in  the  Department  of  Atmospheric  Science,  Colorado  State  University. 
In  the  first  place,  redesign  of  the  unit  was  required  because  of  several 
problems  that  appeared  to  result  from  poor  performance  of  the  existing 
unit.  Later  on  it  wna  made  clear  that  the  problem  was  not  with  the  joy¬ 
stick  unit,  but  rather  in  the  interfacing  circuitry.  Anyhow,  since  the 
system  was  Intended  to  be  switched  over  from  utilizing  an  HP-2100  compu¬ 
ter  to  the  DEC  PDP-11/60  computer,  and  meanwhile,  additional  requirements 
from  the  unit  came  up,  resulting  from  the  accumulating  experience  gained 
by  the  system  users,  a  decision  was  made  to  redesign  and  rebuild  the 
unit  according  to  the  new  requirements.  Building  an  additional  unit  also 
results  in  avoiding  ordinary  system  operating  disturbances  during  the 
transient  period  of  replacing  the  computer. 

This  manual  describes  this  unit  in  detail  as  well  as  describing 
external  subsystems  which  are  not  located  within  the  unit  cabinet,  as 
Interfacing  facilities  or  test  equipment,  for  instance.  Operation  and 
test  and  alignment  procedures  are  also  described. 
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1.0  SYSTEM  BLOCK  DIAGRAM 

1.1  Subsystem  Division: 

The  unit  consists  of  3  main  parts:  The  DC  Subsystem,  the  logic  sub¬ 
system  and  the  power  supplies.  All  those  parts  are  accommodated  in  the 
unit  itself.  External  subsystems,  as  the  interfaces  for  example,  that 
appear  in  the  block  diagram  in  dashed  lines,  or  the  test,  box,  will  be 
described  in  other  following  chapters. 

1.2  DC  Subsystem: 

This  subsystem  Includes  the  circuitry  for  the  Joysticks  and  for  the 
manual  data  potentiometers.  Each  joystick  employs  two  5  kilohm  potentio¬ 
meters,  one  per  each  axis.  In  this  way,  the  DC  subsystem  includes  as 
many  as  8  DC  output  channels.  Those  signals  are  routed  via  the  DC  output 
connector  to  the  Analog-to-Digital  Converter,  which  is  a  multiple-channel 
interface  card,  plugged  in  directly  into  the  PDP-11/60  computer  raain- 
f  rame . 

1. 3  Logic  Subsystem: 

The  main  parts  of  this  subsystem  are  the  16  push-button  keyboard 
and  the  encoding  circuits,  where  the  keyboard  data  are  encoded  into  a 
6-bits  combination.  The  keyboard  Includes  also  2  other  keys:  END  key, 
with  a  yellow  lens,  and  SHIFT  key,  with  an  orange  lens,  marked  with  9. 
The  first  16  keys  have  white  lenses.  Most  of  the  output  signals  are 
buffered  by  line-drivers,  except  SHIFT,  which  is  driven  directly  through 
the  push-button  contacts. 

A  lOOuSec  pulse  is  sent  from  the  logic  to  the  interface  card  (DVC- 
Device  Call),  that  strobes  the  data  bits  into  the  input  register,  which 
is  located  in  the  Interface  card,  type  MDB-11C,  and  also  Initiates  a 
bus-request  that  results  in  an  Interrupt  call. 


DASHED  LINES  BLOCKS  DESCRIBE  SUBUNITS  NOT  LOCATED  WITHIN  THE 
CABINET  ITSELF.  _ 

OTHER  DASHED  LINES  MARK  SUBSYSTEMS  WITHIN  CABINET. 


Fig.  1.1.  JOYSTICK  AND  KEYBOARD  CABINET/BLOCK  DIAGRAM 
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The  16  light  bulbs  in  the  keyboard  puah-buttona  are  controlled 
entirely  by  the  program,  and  the  computer  issues,  from  time  to  time 
according  to  the  software,  a  16-bits  word  which  is  recorded  in  the  MDB 
interface  output  register.  Every  bit  corresponds  to  one  bulb,  the  bit 
DAOO  (least  significant)  corresponding  to  bulb  A,  and  the  bit  DAIS  (most 
significant)  corresponding  to  bulb  S.  The  signals  are  received  in  the 
cabinet  by  line  receivers  and  routed  into  driving  transistors  that  drive 
the  bulbs  lighted. 

1.4  Output  Connectors 

Since  the  two  subsystems  signals  are  routed  to  two  separate  inter¬ 
face  cards,  they  are  also  transferred  via  two  separate  output  connectors. 

J1  is  the  DC  output  connector  (24  pins)  and  J2  is  the  logic  output  con¬ 
nector  (36  pins). 

1. 5  Power  Supplies 

Three  power  supplies  are  necessary  for  the  unit's  proper  operation.  A 
+28V  and  a  -28V  power  supplies  are  required  for  the  DC  subsystem  operation, 
and  a  +5V  power  supply  is  required  for  the  logic  circuitry,  which  consists 
mostly  on  TTL  IC's.  The  current  consumed  by  this  latter  power  supply 
load  is  relatively  high,  about  1.5A,  since  the  +5V  voltage  is  also  required 
for  Illumination  of  the  push-button  bulbs. 
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2.0  SYSTEM  DESCRIPTION 

2.1  Operating  Instructions: 

The  cabinet  accommodates  2  joysticks,  four  5“kilohm  potentiometers 
and  an  18-keys  keyboard.  The  unit  is  packed  in  a  slant-panel  type  DSSF- 
7006  Buckeye  manufactured  cabinet. 

2.1.1  Joysticks: 

Two  joysticks  are  mounted  on  the  slant-front  panel  of  the  unit. 
The  joysticks  are  both  of  type  521-2513,  with  adjustable  friction 
hold  facility  for  each  axis,  manufactured  by  Measurement  Systems, 
Inc.  Joysticks  are  also  equipped  with  a  trim-tab  on  each  axis  to 

facilitate  output  voltage  centering  alignment.  The  left  hand  joy- 

// 

stick  (#1)  is  used  for  assigning  cursor  location  on  the  system  moni¬ 
tor,  while  the  right  hand  joystick  (# 2)  is  used  for  assigning  cursor 
dimensions  (height  and  width).  For  additional  data  about  the  joy¬ 
sticks,  see  Appendix  A. 

2.1.2  Potentiometers 

Four  (4)  identical  panel  controlled  5-kilohms  potentiometers 
are  mounted  on  cabinet  access  panel,  on  its  part  which  is  further 
from  the  operator,  leaving  room  for  the  keyboard  on  the  part  closer 
to  the  operator.  Those  pots  are  used  for  analog  data  manual  assign¬ 
ment.  All  joysticks  and  pots  outputs,  concluding  total  of  8  DC 
channels  of  data,  are  converted  into  digital  data  by  an  8-channel 
A/D  converter,  which  is  plugged  directly  into  computer  card-cage, 
thus  Interfaced  to  the  UNIBUS. 

2.1.3  Keyboard 

The  keyboard  consists  of  16-bit  main  keys  and  2  auxiliary  keys. 
The  16-bit  keys  are  marked  A  through  S,  skipping  the  letters  I,  0 
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and  Q  so  that  they  will  not  be  confused  with  one,  zero  or  with  each 
other.  The  16  keys  represent  a  keyboard  on  which  messages  can  be 
keyed  in.  The  keys  can  be  illuminated,  and  their  illumination  is 
entirely  program  controlled.  The  program  only  can  decide  which  key 
will  be  illuminated  and  when.  Every  press  on  a  key  is  encoded  into 
a  6-bit  word  according  to  the  following  table  (6  bits  word  repre¬ 
sented  in  octal  code). 


A  -  22 

J  -  11 

B  -  01 

K  -  10 

C  -  02 

L  -  20 

D  -  03 

M  -  30 

E  -  04 

N  -  40 

F  -  05 

P  -  50 

G  -  06 

R  -  60 

H  -  07 

S  -  70 

Table  2.1  Keyboard  Code 

The  six  bits  are  read  into  the  six  least  significant  data  lines  of 
the  UNIBUS. 

Besides  those  16  keys  there  are  2  other  ones:  END  key,  with 
a  yellow  lens,  generates  a  "1"  level  in  the  eighth  data  line  (DA07) 
and  the  SHIFT  key  with  an  orange  lens,  marked  with  an  arrow  (+) , 
generates  a  "1"  level  on  the  seventh  data  line  (DA06).  The  illumi¬ 
nation  of  those  two  push-buttons  is  not  computer  controlled.  The 
SHIFT  key  is  illuminated  only  while  being  pressed,  and  the  END  key 
is  illuminated  upon  pressing,  and  stays  illuminated  until  another 
key  (other  than  SHIFT)  is  pressed. 
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Every  press  on  such  a  key  (ocher  than  SHIFT)  generates  also  an 
Interrupt  call  to  the  computer,  the  subroutine  of  which  tells  it  to 
read  the  depressed  key's  code.  The  SHIFT  key  by  itself  does  not 
generate  any  interrupt,  unless  it  is  pressed  in  conjunction  with 
another  key,  Che  way  it  is  done  in  conventional  keyboards.  Note 
Chat  when  the  SHIFT  key  is  to  be  used,  it  has  to  be  pressed  prior 
to  the  other  key,  and  kept  pressed  while  the  other  key  is  pressed. 

In  this  way  a  completed  correct  bit  combination  is  guaranteed  for 
the  data  lines  prior  to  generation  of  the  interrupt  call.  The  unit 
also  generates  a  power  status  level,  that  indicates  the  presence  of 
power  in  the  unit.  The  absence  of  this  level  indicates  that  the 
unit  is  not  available  for  the  computer,  whether  it  is  since  power 
is  off,  or  the  unit  is  disconnected  from  the  interface  card. 

2.2  Electrical  Specifications 

2.2.1  Joysticks 

2. 2. 1.1  Power  requirements: 

Voltage:  +  28VDC 

Voltage  Stability:  +  .01% 

Current  Consumption:  60  mA  max  (each  power  supply) 

2.2. 1.2  Output  Characteristics: 

Max  Voltage  Swing:  +  5VDC 

Equivalent  Output  Impedance:  3  Kft  max  (each  channel) 

Minimum  Permissible 

Load  Impedance  for  Error  <.01%:  15  MO  (each  channel) 

Center  Position  Output:  OV 

2.2.2  Potentiometers: 

2.2. 2.1  Power  Requirements: 
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Voltage: 

Voltage  stability: 

Current  Consumption: 

2. 2. 2. 2  Output  Characteristics: 

Max  Voltage  Swing: 

Equivalent  Output  impedance: 
Minimum  Permissible  load 
Impedance  for  error  <.01%: 
Pot.  Center  position  Output: 
2.2.3  Keyboard 
2.2.3. 1  Output  Voltage  level: 

High  -  A. 5  VDC  min. 

Low  -  0.7  max.  VDC 


2. 2. 3. 2 

Output  Current  level: 

High  source  -  2  mA 

Low  sink  -  200  mA 

2. 2. 3. 3 

Power  requirements: 

Voltage: 

5  +  .25  VDC 

Current: 

1. 5A  max. 

2. 2. 3. 4 

Power  status  level: 

High  when 

OK 

Voltage: 

5  +  1VDC 

Impedance: 

2.2  iOl  max. 

2. 2. 3. 5 

Data  bit  level: 

High  when 

data  0 

(output  connector) 

Low  when  < 

data  1 

3.0  DC  CIRCUITRY 

3. 1  Joystick.  Circuitry 

The  output  of  the  joystick  potentiometers  should  be  within  the  limit 
of  +  5V,  to  comply  with  the  A/D  converter  requirements.  Since  the  total 


+  28  VDC 
+  .01% 

10  mA  max  (each  power  supply) 

+  5VDC 

10  Kfl  max  (each  channel) 

40  MO  (each  channel) 

OV 
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lever  excursion  covers  only  +  11%  of  the  pot.  resistance,  a  much  higher 
supply  voltage  has  to  be  applied.  For  this  reason  power  supplies  of  +  28V 
are  employed.  The  series  small  resistors  are  in  use  for  alignment  pro¬ 
cedure,  while  output  symmetry  is  accomplished  by  the  joystick  trim-tabs. 

3. 2  Potentiometers  Circuitry: 

The  manual  data  potentiometers,  not  like  the  joysticks,  cover  their 
whole  resistance  range  by  manual  rotation.  Therefore,  in  order  to  have 
their  output  voltage  kept  within  the  limit  of  +  5V,  according  to  the  A/D 
converter  requirements,  they  have  in  series  much  higher  resistances. 

Two  separate  trimming  resistors  are  also  required,  since  there  are  no 
trim=tabs  and  output  voltage  centering  cannot  be  achieved  by  any  other 
way. 

3.3  Polarity: 

Joystick  horizontal  output  voltage  increases  towards  +  5V  value  by 
moving  the  lever  from  the  left  to  the  right.  Vertical  output  increases 
similarly  when  lever  is  moved  down.  Manual  data  potentiometers  output 
voltage  increases  when  pots  are  rotated  clockwise. 

3.4  Output  Wiring: 

Due  to  the  length  of  the  cable,  connecting  the  unit  to  the  A/D  card, 
it  is  recommended  to  use  true  differential  input  connection,  though  all 
input  voltages  are  referred  to  ground.  The  common  point  of  the  two  series 
28V  power  supplies  will  be  used  as  ground  for  this  case,  and  will  be 
connected  to  one  of  each  conductor  twisted  pairs  leaving  the  unit  via  the 


DC  output  connector. 


Fig.  3.1. 

DC  CIRCUIT  SCHEMATIC 
JOYSTICK  CABINET 
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Jl/24  Pins 

Hi  Row  _  _  Low  Row 


Pin  it 

Color 

Sig. 

Pin  it 

Color 

Sig. 

1 

Brn 

+28V 

13 

Blk 

+28V 

2 

Red 

JS1H+ 

14 

Blk 

JSIHGnd 

3 

Org 

JS1V+ 

15 

Blk 

JSIVGnd 

4 

Yel 

JS2H+ 

16 

Blk 

JS2HGnd 

5 

Gra 

JS2V+ 

17 

Blk 

JS2VGnd 

6 

Blue 

28VGnd 

18 

Blk 

28VGnd 

7 

Brn 

P1+ 

19 

Red 

PIGnd 

8 

Org 

P2+ 

20 

Red 

P2Gnd 

9 

Yel 

P3+ 

21 

Red 

P3Gnd 

10 

Grn 

P4+ 

22 

Red 

P4Gnd 

11 

(Blue) 

N.C. 

23 

(Red) 

N.C. 

12 

Blk 

-28V 

24 

Wht 

-28V 

All  wires  twisted  pairs. 


Table  3.1.  DC  Output  Connector  Wiring  List. 
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4.0  LOGIC  CIRCUITRY 

4. 1  Purpose: 

Logic  circuitry  is  the  term  assigned  to  the  circuitry  encountered 
with  the  keyboard  push-buttons.  Those  keys  are  mounted  in  the  unit  in 
order  to  enable  keying-in  of  messages  for  system  control  purposes. 

4.2  Selected  Push-Button  Type: 

The  16-bits  push-button  were  chosen  to  be  of  type  SPDT,  that  is,  one 
normally-closed  and  one  normally-open  contacts,  with  a  common  point.  This 
was  done  in  order  to  enable  the  design  of  a  circuit  that  will  Inhibit 
generation  of  more  than  one  call  by  the  same  press  of  a  button  due  to 
contact  bouncing.  Only  after  the  key  returns  to  its  normally  closed  posi¬ 
tion,  a  new  call  by  another  press  is  enabled. 

The  keys  for  the  END  and  SHIFT  purposes  are  DPST,  due  to  the  other 
mode  they  operate.  In  both  cases,  the  lamp  contacts  are  separate  and 
the  light  is  controlled  by  external  circuitry. 

4.3  Electronic  circuit: 

4.3.1  Encoders: 

Since  there  are  no  encoders  available,  that  convert  one-out-of-16 
input  into  a  4-bit  combination,  two  encoders  for  one-out-of-eight 
conversion  into  3-bits  combination  are  in  use.  Thus,  the  encoded 
combination  occupy  6  bits  rather  than  4,  but  there  are  still  unassigned 
bits  in  the  data  word  for  use. 

Since  both  A  and  J  push-buttons  encode  an  all-zero  combination 
in  the  encoders,  the  program  might  not  distinguish  between  those  two 
buttons.  Therefore,  the  22„  and  lla  encoded  combinations  were  imple- 

O  O 

mented,  directly  by  the  line  drivers,  rather  than  the  encoders  (see 
paragraph  4.3.3). 
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4.3.2  One-Shot  Circuits; 

Two  sequential  one-shot  multivibrators  are  operated  by  every 
press  of  a  key  (again,  excluding  SHIFT).  The  first,  of  SOOuSec, 
yields  a  delay  to  enable  skipping  all  the  bouncing  transients  that 
might  occur  when  a  key  is  pressed.  The  second  pulse,  of  lOOySec, 
is  used  as  a  strobe  for  loading  the  input  data  register  and  setting 
the  DONE  flip-flop,  which  asserts  in  turn  the  interrupt  call.  The 
latter  mentioned  electronic  circuits,  as  the  input  data  register  and 
the  DONE  flip-flop  are  not  located  in  the  unit  but  on  the  interface 
card. 

4.3.3  Line  Drivers: 

The  logic  outputs  to  the  back-panel  connector  are  buffered  by 
line-drivers  type  IX75451P.  END  lamp  is  also  driven  by  such  a  driver. 
Only  the  SHIFT  and  PWL  (power  status  bit)  which  are  not  generated 
by  TTL  circuits  but  directly  by  the  push-button  contacts  or  the 
power-line,  are  connected  directly  to  the  connector.  Every  driver 
has  two  inputs  AND  functioned,  and  the  unused  inputs  are  generally 
connected  to  the  Hi  level,  except  for  the  two  cases,  that  the  combi¬ 
nations  llg  and  22g  have  to  be  encoded.  This  is  done  directly 
through  the  other  inputs,  that  are  not  connected  to  the  encoder 
outputs. 

4.4  Status  Bits: 

The  only  status  bit  generated  within  the  unit  is  the  Power  status 
(PWL)  which  appears  in  the  13th  level  (DA14).  The  other  2  bits,  ERROR 
(DA15)  and  DONE  (DA13),  are  generated  in  the  interface  card.  The  check 
level  is  generated  by  the  +5V  supply  power  source,  in  series  with  a  22000 


resistance. 
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4.5  Data  Input  Word  Format; 

The  final  structure  of  the  Input  word  will  be  as  follows;  The  Low 
Order  Byte  (L.O.B.)  shows  data  information  (pressed  push-buttons).  The 
High  Order  Byte  (H.O.B.)  shows  the  status  by  the  three  most  significant 
bits.  The  other  bits  are  not  applicable. 


A  v> 

^ 


^ 

<y  v  <y  <y  v 


N. 


\\> 


j_s 

CODE 


A-H 

CODE 


Fig.  4.1.  Input  Data  Register  Format 
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P.CB 


LOGIC  SECTION/ ENCODING  CIRCUIT 


LEAST  SIGNIFICANT 


Fig.  4.2.b. 

JOYSTICKS  &  KEYBOARD  CABINET 
LOGIC  SECTION/ ENCODING  CIRCUIT 


MOST  SIGNIFICANT 


Fig.  4.3. 

LOGIC  SECTION  TIMING  DIAGRAM 


*d  -  The  delay  Implied  by  the  distance  between 
breaking  the  N.C.  contacts  and  making 
the  N.O.  contacts 
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note:  ALL  Rs  ARE  2200  ohm  +vc 


Fig.  4.4. 

JOYSTICKS  &  KEYBOARD  CABINET 
LOGIC  SECTION/SHIFT,  EOM  &  DEVICE  CALL  CIRCUITS 


CONNECTOR 

PINS 


DA03  3 


42  DA03L 


DAO  2  _ 2 


(15)  7 1 


Upper 


41  0A02L 


e  pay 


DAO I  L_L 


(11)7  ° 

tmTfii  Lower 


94  1  DAO  I L 
*691  JP 


. .  w.8. 

CONNECTOR 

CONTACTS 

R9D00L  I  36  {- 


U9  PINS  4XLMI489A  3X  7406 

_ _  PA0S  CONTACTS 


R  .  .4 


rrr- _ 21 


R9D0IL  35 


R0DO2L  |  88 


R0DO3L  89 


R9D04L  I  38 


R9005L  I  39 


R9D06L  j  40 


R9007L  I  90 


R9008L  |82 


R9009L  [81 


R8DI0L  [83 


R0DIIL  29 


R0OI2L  |2 1 


R  I 


1 3  rv_4i 


/ — 0  i 

R _ Ll3hs — II 


^  Lsri^i. 


270  fL 


8 


'r^EnLTu1 


A-0  | 

R  nr^-3 


R  |4|V^6 


^4 

I  u,0  • 

Il3h^l2t 


iirv_ioi 


3 


I  U„  I 

,131^121 


&J 


R90I3L  |  30 


R9DI4L  [19 


R9DI5L  [  18 


R  liors^  8 


R  I 


U|2 

5  r^_6 


i3  r^j2l 


NOTE  :  ALL  R  RESISTORS  ARE  LOCATED  IN  A  3I6A222  RESISTOR  NETWOR 
THEIR  OTHER  END  IS  CONNECTED  TO  +  5V 


JOYSTICK  fc  KEYBOARD  CABINET 
LOGIC  SECTION/LAMP  DRIVING  CIRCUIT 


Fig.  4. 7. a. 

LAMP  CIRCUIT  LEAST  SIGNIFICANT 


Fig.  4.7.d. 
EOM  CIRCUIT 
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CONNECTOR  WIRING  LIST 
J2/36  Pins 


Hi  Row 

Lo  Row 

Pin  # 

Color 

Sig. 

Pin  9 

Color 

Sig. 

1 

Bm 

+5V 

19 

Blk 

3VGnd 

2 

Red 

A(RD0OOL) 

20 

Blk 

E(RD0O4L) 

3 

Org 

B(RD901L) 

21 

Blk 

F(RD0O5L) 

4 

Yel 

C(RD0O2L) 

22 

Blk 

G(RD0O6L) 

5 

Grn 

D(RD0O3L) 

23 

Blk 

H(RD0O7L) 

6 

Blu 

E0ML 

24 

Blk 

E0pGnd 

7 

Brn 

DAO  5 

25 

Red 

DA05Gnd 

8 

Org 

DA04 

26 

Red 

DA04Gnd 

9 

Yel 

DA03 

27 

Red 

DA03Gnd 

10 

Grn 

DA-2 

28 

Red 

DA02Gnd 

11 

Blu 

DA01 

29 

Red 

DAOIGnd 

12 

Blk 

DAOO 

30 

Wht 

DAOOGnd 

13 

Red 

DVCL 

31 

Wht 

DVCLGnd 

14 

Grn 

J (RD0OSL) 

32 

Wht 

N(RD012L) 

15 

Blu 

K(RD0O9L) 

33 

Wht 

P(RD013L) 

16 

Brn 

L(RD01OL) 

34 

Grn 

R(RD014L) 

17 

Org 

M(RD011L) 

35 

Grn 

S(RD015L) 

18 

Yel 

PWL 

36 

Grn 

SHIFTL 

all  wires 

"*  " 

twisted  pairs 

Table  4.1  Logic  Output  Connector  J2  Wiring  List. 
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5.0  POWER  SUPPLIES 

5.1  Requirements: 

General  requirements  from  the  power  supplies  are  as  follows: 

1)  2  28V  stabilized  sources  are  required  for  the  DC  System. 

The  sources  have  to  be  connected  in  series  to  form  a  dual- 
symmetry  positive-negative  source. 

2)  1  5V  source  for  the  logic  supply  (including  bulbs). 

3)  The  current  requirements  are  as  shown  in  the  specification 
tabic  (p.  2.2),  l.e.  each  28V  supply  should  yield  at  least 
70  mA,  and  the  5V  supply  should  yield  at  least  1.5A. 

5.2  Power  Supply  Chosen: 

Practically,  type  22  SM  series  submodular  Powertec  power  units  are 
employed.  Two  units  are  of  type  22A-500,  that  are  used  as  28V  0.475A 
sources.  The  unit  used  as  5V  power  supply  is  of  type  22B-100,  that  can 
yield  5V  at  3A  current. 

5.3  Fuses: 

Each  power  supply  has  its  own  fuse,  over  voltage  protector  and  cur¬ 
rent  limiter.  Therefore,  no  additional  fuses  or  other  protecting  devices 
are  employed  in  the  unit. 

5.4  Power  Supply  Data: 

Detailed  data  sheets  of  the  submodular  power  units  are  to  be  found 
in  Appendix  B. 

5.5  Transformers: 

Two  separate  transformers  are  used  for  power  supply.  Stancor  type 
p-8653  is  used  for  5V  supply,  and  Stancor  type  p-8675  (with  dual  secondary 
winding)  is  used  for  the  2  28V  supplies. 


2 


6RN 


FROM  5V 
PWR  SUPPLY 


Fig.  5.1. 

TB1-POWER  SUPPLY  TERMINAL  BOARD  CONNECTIONS 
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6.0  TEST  AND  ALIGNMENT  PROCEDURE 

6. 1  Power  Supply  Voltage  Adjustment! 

6.1.1  Connections  and  Turning  the  Unit  On: 

a)  Connect  unit  to  Teat-Box  by  plugging  CC1  to  receptacle  J1 
In  the  Joystick  Cabinet  rear  panel,  and  CC2  to  the  recep¬ 
tacle  J2.  Also  connect  a  DC  voltmeter  or  DVM  to  the  top 
binding  posts.  Test-Box  is  described  in  Appendix  C. 

b)  Plug  Power  Cord  to  115VAC  power  connector. 

c)  Turn  the  unit  on  by  pressing  POWER  push-button.  Note  that 
green  lens  of  push-button  is  illuminated,  as  well  as  PWR  ST 
indicator  on  the  Test-Box.  No  other  indicator  light  on 
unit  or  on  Test-Box  should  be  illuminated. 

6.1.2  Adjustments: 

6. 1.2.1  +28V  adjustment: 

a)  Set  selector-switch  on  front  panel  of  Test-Box  to 
+28V  position. 

b)  Notice  reading  of  voltmeter.  Reading  should  be 
28  +  0.1V.  If  reading  is  different,  adjust  +28V 
power  supply  using  a  long,  thin  screwdriver. 

6. 1.2. 2  -28V  adjustment: 

a)  Set  selector-switch  on  Test-Box  to  -28V  position. 

b)  Adjust  reading  to  28V  as  in  6.1.2.1b.  No  need  to  invert 
polarity  of  voltmeter  probes. 

6. 1.2. 3  +5V  adjustment: 

a)  Set  selector-switch  on  Test-Box  to  5V  position. 

b)  Adjust  voltage  to  5  +  0.1V  and,  if  necessary,  select 
a  better  measurement  range  of  voltmeter. 


J 


30 


6.2  DC  Section  Test: 

6.2.1.  Connections  and  Presetting: 

a)  Connect  a  10VDC  voltmeter  to  the  top  binding-posts  of  the 

Test-Box.  The  voltmeter  should  be  preferably  a  +  10V  reading 
with  a  zero-centered  pointer,  or  a  +  reading  DVM.  Positive 
input  to  red,  negative  input  to  black  binding  posts. 

6.2.2.  Joystick  Output  Adjustments: 

a)  Move  J.S.  # 1  (Left-hand)  to  its  extreme  right  position. 
Vertical  position  needs  not  to  be  changed. 

b)  Note  that  VM  reading  should  be  +5V.  If  it  is  not,  use 
trimpot  R1H  for  adjustment. 

c)  Move  J.S.  #1  to  extreme  left  position.  The  VM  reading 
should  now  be  -LV.  If  it  is  not,  use  horizontal  trim-tab 
for  adjustment. 

d)  Repeat  steps  a,  b  and  c  for  several  times  until  output 
voltages  are  +5V  at  the  joystick  extreme  positions.  Output 
at  the  center  position  should  be  zero. 

e)  Turn  rotary  selector  switch  to  next  position,  JS1V 

f)  Move  J.S.  //I  lever  to  extreme  lower  position  and  adjust 
reading  of  VM  to  +5V,  using  trimpot  R1V. 

g)  Move  J.S.  #1  lever  to  extreme  upper  position,  and.  adjust 
reading  of  VM  to  -5V,  using  vertical  trim-tab  for  adjust¬ 
ment. 

h)  Repeat  steps  f  and  g  for  several  times,  until  output  voltages 
are  +  5V  at  the  joystick  extreme  vertical  positions.  No 
need  of  changing  horizontal  lever  position  during  vertical 
alignment. 
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i)  Repeat  steps  a  through  h  for  J.S.  #2  (right-hand),  using 
selector  switch  position  JS2H  and  JS2V  in  lieu  of  JS1H  and 
JS1V,  respectively.  Adjust  output  voltages  using  trimpots 
R2H  and  R2V  in  lieu  of  R1H  and  R2V,  respectively.  Negative 
outputs  should  be  adjusted  using  J.S.  H2  trim-tabs. 

j)  Note  that  after  alignment  procedure,  all  4  joystick  output 
readings  should  be  zero,  if  both  joystick*  are  in  center 
position. 

k)  Lock  joystick  levers  using  locking  screws,  and  check  that 
they  are  locked  in  position. 

6.2.3.  Manual  Data  Potentiometers  Alignment: 

a)  Turn  rotary  selector-switch  on  Test-Box  to  position  PI. 

b)  Turn  Pot  #1  to  maximum  clockwise  (CW)  position,  and  adjust 
VM  reading  to  be  +5V,  using  RVIU  trimpot  for  adjustment. 

c)  Turn  Pot.  #1  to  maximum  counter-clockwise  (CCW)  position, 
and  adjust  VM  reading  to  be  -5V,  using  RV1L  trimpot  for 
adj ustment. 

d)  Repeat  steps  b  and  c  for  several  times,  until  no  more 
adjustments  are  necessary  for  Pot.  #1. 

e)  Turn  selector  switch  to  position  P2,  and  repeat  procedure 
described  in  b,  c,  and  d  for  Pot.  #2,  using  RV2U  and  RV2L 
in  lieu  of  RVIU  and  RV1L,  respectively. 

f)  Use  the  same  procedure  for  adjustments  of  Pots.  #3  and  it 4, 
setting  selector  switch  to  positions  P3  and  P4,  respectively. 
For  adjustments,  use  RV3U  and  RV3L  for  P3,  and  RV4U  and  RV4L 


for  P4. 


6.3.1.  Auxiliary  Keys  Test: 

a)  Press  SHIFT  push-button  and  note  that  all  indicating  LED's 
on  the  Test  Box  panel  are  dark,  except  PW  ST,  which  will 
stay  illuminated  through  all  the  procedure. 

b)  Press  END  push-button  and  note  that  EOM  indicator  will  be 
illuminated,  in  conjunction  with  DVC  indicator  on  the  Teat- 
Box  panel.  The  push-button  itself  should  be  also  illumi¬ 
nated.  Both  indicators  should  stay  illuminated  after  push¬ 
buttons  are  released. 

c)  Press  SHIFT  and  note  that  DVC  indicator  will  turn  off. 

The  push-button  itself  should  be  lighted  only  when  pressed. 

d)  Note  that  EOM  Indicator  on  the  Test-Box  panel  and  END  push¬ 
button  are  still  illuminated. 

6.3.2.  16  Main  Keys  Test: 

a)  Press  the  key  marked  A.  Note  that  the  key  itself  is  not 
illuminated. 

b)  Note  that  EOM  indicator  will  turn  off,  and  DVC  will  turn  on. 

c)  Among  the  Indicators  DAO  to  DA5,  the  Indicators  DAI  and 
DAA  only  will  be  illuminated. 

d)  Release  A  key.  DA2  and  DA4  should  turn  off.  DVC  should 
remain  illuminated. 

e)  Press  SHIFT  key  and  note  that  DVC  indicator  will  turn  off. 
SHIFT  push-button  itself  will  be  illuminated  only  when 
pressed. 

f)  Repeat  steps  a  through  e*  for  all  other  15  keys,  B  through 


Since  EOM  test  is  not  repeated,  turn-off  of  EOM  as  indicated  in  step 
b  will  not  repeat  for  other  15  keys  test. 
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S.  Illumination  code  of  DAO  through  DA5  for  all  keys  Is  as 
follows:  (N-ON,  F-OFF) 


Key 

A 

B 

C 

D 

E 

F 

G 

H 

J 

K 

L 

M 

N 

P 

R 

S 


DA5  DAA  DA3  DA2  DAI  DAO 


F  N 
F  F 
F  F 
F  F 
F  F 
F  F 
F  F 
F  F 
F  F 
F  F 
F  N 
F  N 
N  F 
N  F 
N  N 
N  N 


F  F 
F  F 
F  F 
F  F 
F  N 
F  N 
F  N 
F  N 
N  F 
N  F 
F  F 
N  F 
F  F 
N  F 
F  F 
N  F 


N  F 
F  N 
N  F 
N  N 
F  F 
F  N 
N  F 
N  N 
F  N 
F  F 
F  F 
F  F 
F  F 
F  F 
F  F 
F  F 


Table  6.1  Keyboard  Code 


6. A  Puah-Buttona  Illumination  TeBt: 

a)  Note  that  all  white  push-buttons  Illumination  lenses  are 
dark. 

b)  Press  Lamp-Test  push-button  on  the  Test-Box  panel,  and  note 
that  all  push-button  illumination  lenses  turn  to  be  lighted. 
They  will  return  to  the  previous  position  when  the  test 
push-button  is  released. 

c)  Note  that  this  test  concerns  only  the  white  lens  push¬ 
buttons,  and  not  END  or  SHIFT. 
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6.5  Disconnecting  Unit  from  Test-Box: 

Turn  power  off,  then  disconnect  CC1  and  CC2  from  J1  and  J2,  respec¬ 
tively. 

ATTENTION! 

The  unit  has  a  built-in  power  supply!  Remember  to  turn  unit  power 
off  before  connecting  to  interface  cards.  Power  may  be  restored  only 
after  connection  to  interface  is  accomplished. 


7.0  INTERFACING  MODULES 


General  information: 

Since  the  unit  operates  as  two  units  without  any  necessary  connection 
between  each  other,  it  is  interfaced  to  the  computer  by  two  separate  inter¬ 
face  units.  The  DC  section  is  Interfaced  through  an  A/D  card  Model 
635/ HAD,  manufactured  by  ADAC.  the  logic  section  is  interfaced  through 
a  general  purpose  interface  module  type  MDB-11C,  manufactured  by  MDB 
Systems,  Inc. 

Those  two  cards  are  described  in  Appendices  D  and  E,  respectively. 
However,  several  specific  wiring  works  had  to  be  done  for  fitting  those 
cards  to  this  specific  application,  especially  in  the  MDB  card,  where 
user's  interface  circuits  had  to  be  added.  This  chapter  describes  those 
specific  circuitries. 

7. a.  Analog  to  digital  interface. 

7.a. 1.  Card  Model: 

There  are  many  options  that  can  be  purchased  together  with  the 
card  type  635/11AD. 

7. a. 1.1  Number  of  Channels: 

The  smallest  number  of  channels  possible  on  this  card  is  16, 
if  it  is  used  as  a  single  ended  input.  But  since  about  30'  of 
cable  connect  the  DC  source  (Joystick  unit)  to  the  card,  differential 
input  mode  has  to  be  used,  and  this  reduces  the  effective  number  of 
channels  by  one  half,  i.e.  it  is  now  8  channels. 

7. a. 1.2.  Input  Voltage  Range: 

Practical  value  is  +  5V  (see  3.1) 

7. a. 1.3.  DAC’s 

No  DAC  (Digital  to  Analog  Converters)  are  needed  now.  It  is 
possible  to  add  ones  in  the  future. 


k. 
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7.a.l.4  DMA  Compatibility: 

No  DMA  Compatibility  is  required.  Hence,  the  resulting  type 
number  is  as  follows: 

635/11AD-8DI-C-0-0-0.  See  details  in  Module  instruction  manual. 
7.b.  MD8-11C  Interface  Card: 

7.b.l 

The  card  includes  all  the  required  logic  for  connections  to  the 
UNIBUS,  and  is  described  in  Appendix  E.  Anyhow,  additional  user's 
interface  is  required,  to  enable  connections  to  the  joystick  cabinet. 
This  additional  logic  is  described  in  this  chapter. 

7.b.2.  Flow  Chart: 

The  flow  chart  described  consists  of  two  parts:  the  one  con¬ 
cerning  the  interrupt  logic  on  the  left,  and  the  one  concerning 
read  and  write  operations  on  the  right.  Naturally,  the  right  opera¬ 
tion  proceeds  the  left,  but  the  writing  operation  is  by  nature  inde¬ 
pendent  of  the  interrupt.  Besides,  in  case  of  an  error,  the  pro¬ 
cessor  might  initiate  a  read  operation  without  DONE  ready,  and  this 
is  a  possibility  that  has  to  be  considered.  Therefore,  the  reading 
and  writing  series  of  steps  is  described  independently. 

7.b.3.  Block-Diagram: 

The  block  diagram  is  divided  into  3  parts:  the  left  hand 
includes  the  section  built  in  the  joystick  cabinet,  and  its  descrip¬ 
tion  is  given  in  detail  in  Chapter  4.  The  right  hand  part  includes 
the  logic  already  built  on  the  interface  card,  which  is  discussed 
in  Appendix  E.  The  mid-part  is  the  user's  interface  which  is  de¬ 
scribed  in  this  chapter,  and  the  schematics  of  which  are  given  here. 
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READ  a  WRITE 
CYCLE 


*L,0,B,  -  LOW  ORDER  BYTE 
**H,O.B,  -  HIGH  ORDER  BYTE 


Fig.  7.2. 

KEYBOARD  INTERFACE 
BLOCK  DIAGRAM 
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7.b.4.  Logic  Schematics: 

No  signals  are  transferred  from  the  keyboard  circuit  to  the 
interface  through  line  receivers:  the  6  encoded  bits,  the  auxiliary 
keys  END  and  SHIFT,  and  the  signals  DVCL  and  PWL  (Power  status  bit). 
All  of  them,  except  SHIFTL  and  PWL  are  transferred  through  twisted¬ 
pairs  conductors,  because  of  their  speed.  The  other  two  are  DC  sig¬ 
nals  and  can  be  transferred  in  single  leads. 

Loading  of  the  input  register  is  divided  into  two  bytes,  the 
Low  Order  Byte  (LOB)  that  includes  the  date  from  the  keyboard  is 
loaded  by  the  DVC  signal.  The  H.O.B.  which  is  the  status  part  of 
the  word,  and  depends  on  the  circumstances  the  input  word  is  read 
by  the  processor,  is  loaded  by  the  DSYN  pulse  of  a  read  operation. 

The  lamp  control  circuit  is  connected  to  the  output  register  and 
operates  entirely  separated  from  the  other  circuitry. 

7.b.5.  Jumpers: 

7.b.5.1.  Address  decoding: 

The  address  assigned  for  the  keyboard  device  is  764020.  This 
address  location  is  used  both  for  reading  the  combined  input  byte 
and  status  byte  word,  as  well  as  for  writing  in  the  output  register 
the  illuminated  key  bulbs  combination.  However,  due  to  the  internal 
construction  of  the  MDB-11C  module,  the  board  will  respond  also  to 
addresses  764022,  024,  and  026,  although  those  locations  are  not 
in  use.  Hence,  those  locations  must  not  be  addressed  by  any  program. 
7.b.5.2.  Interrupt  Vector: 

The  interrupt  vector  for  the  keyboard  is  assigned  to  be  324 
(11010100).  The  bus-request  process  takes  place  at  priority  level 
4  (BR4-BG4) . 
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Fig.  7.3. 

MDB-11C  INTERFACE  CARD 
LINE  RECEIVERS  CONNECTIONS 
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Fig.  7.4. 

MDB-1LC  INTERFACE  CARD 
REGISTERS  CONTROLS  &  INTERRUPT  LOGIC 
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Fig.  7.5. 

MDB-11C  INTERFACE  CARD 
LAMP  CONTROL  REGISTER  OUTPUTS 


7.b.5.3.  Jumpers  List: 


A  list  of  the  points  that  are  Jumpered  for  Implementing  the 
above  mentioned  combinations,  for  the  address  location  as  well  as 
for  the  Interrupt  vector  and  the  required  priority  level,  is  listed 
at  the  end  of  Appendix  E. 
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8.0  SOFTWARE  TIPS 

8.1  General: 

The  structure  of  the  Interface  cards  (A/D  Module  and  MDB  general 
purpose  Interface  card)  leaves  many  options  for  use  according  to  different 
softare  orientations.  For  instance,  the  digitized  information,  processed 
by  the  A/D  converter,  can  be  routed  into  the  processor  in  2  ways:  a)  pro¬ 
gram  controlled,  i.e.  the  software  has  to  check  repeatedly  the  DONE  bit 
in  the  status  word,  and  after  it  is  found  to  be  1,  a  data-read  operation 
takes  place,  b)  Interrupt  controlled,  i.e.  the  interface  issues  an 
interrupt  call  after  a  conversion  process  is  completed.  Another  example 
is  the  mode  of  triggering  the  ADC.  Since  moat  of  those  hardware  selections 
have  software  implications,  software  orientation  should  be  indicated  after 
the  hardware  selections  have  been  made. 


assumptions 
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Fig.  8.1. 
ADC  SUBROUTINE 
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8. 3  Keyboard  Programming: 

In  the  general  purpose  interface  module  there  is  no  facility  for 
enabling  or  disabling  the  interrupt.  The  Interrupt  logics  is  always 
enabled  and  there  is  no  status  register.  Those  facts  make  the  programming 
a  straight-forward  task.  The  program  has  to  wait  for  the  interrupt  call, 
and  when  it  arrives,  the  only  operation  that  has  to  take  place  is  a  read 
operation.  The  read  operation  should  be  proceeded  by  checking  the  status 
(High-order  byte)  for  an  error  or  malfunction,  and  if  everything  is  OK, 
validate  the  read  data.  The  writing  operation,  which  means  controlling 
the  push-buttons  illumination  is  Independent  of  the  interrupt  and  is 
entirely  program-controlled. 
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Fig.  8.2. 

MDB-11C  MODULE  SUBROUTINE 
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The  test-box  described  in  this  appendix  is  designed  to  be  connected 
to  the  unit  instead  of  the  interface  cards  through  two  cable  mounted  con¬ 
nectors:  CC1  connected  to  J 1  (DC  connector)  and  CC2  connected  to  J2 
(Logic  connector).  The  test-box  has  no  built  in  power  source,  and  has  to 
be  furnished  by  the  DC  supply  from  the  unit  under  test.  For  this  purpose, 
and  for  the  supply  voltage  measurement  purpose,  all  the  supply  voltages, 
428V,  -28V,  28VGND,  +5V  and  5VGND  appear  in  the  rear  panel  connectors  J1 
and  J2,  although  they  are  not  routed  further  onto  the  Interface  during 
current  regular  operation  except  of  the  2  grounds,  that  have  to  be  routed 
to  the  interface  for  common  grounding  purposes.  The  DC  section  contains 
the  selector  switch  and  the  two  binding-posts  for  connecting  a  voltmeter 
or  a  DVM.  The  selector  can  select  each  of  the  3  supply  voltages  and  each 
of  the  4  pots  and  the  2  joysticks  output  (each  axis  of  each  joystick), 
total  number  of  11  positions. 

The  logic  section  test  circuits  contain  display  indicators  for  the 
encoded  bits  and  a  flip-flop  to  record  the  Device-Call  pulse,  which  is 
too  narrow  (100  pSec)  to  observe  directly.  The  SHIFT  signal  is  used  for 
resetting  this  flip-flop.  The  recorded  DVC  signal  is  also  displayed  on 
an  LED  indicator,  as  well  as  the  EOM  and  the  power  status  signal. 

Besides,  there  is  a  separate  push-button  to  test  the  illumination 
bulbs  in  the  16  keys  that  operate  by  externally  received  signals. 

Since  the  joystick  unit  has  a  built-in  power  supply,  it  is  recommended 
to  turn  its  power  off  before  connecting  or  disconnecting  the  unit  to  or 
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Analog  to  Digital  Converter 


Model  635/11AD 

Manufactured  by  ADAC  Corporation 


The  module  described  in  this  appendix  is  built  on  a  single  card  and 
serves  as  a  general  purpose  interface.  In  this  application  it  is  used  for 
transfer  of  keyboard  information  and  controlling  keyboard  illumination. 

The  logic  on  this  card  has  inlet  points,  to  which  the  logic  described  in 
chapter  7.b  is  connected.  Connections  can  be  identified  by  the  numbered 
points. 

Apart  from  the  users  interface,  some  internal  connections  junipers 
had  to  be  striped,  according  to  software  considerations.  The  card  has 
no  DMA  capability,  and  requests  bus-control  for  issuing  interrupt  calls 
only.  It  has  the  capability  of  issuing  two  separate  interrupt  calls, 
assigning  a  separate  vector  address  for  each  one  and  a  capability  of 
requesting  bus  control  on  a  different  or  equal  priority  levels.  In  this 
case  only  one  interrupt  level  is  used  (DEVINT1) ,  and  the  bus-request  and 
bus  grant  take  place  on  level  //4  (BR4-BG4) .  Jumpers  are  striped  accor¬ 
dingly. 

On  the  following  page  jumpers  connection  lists  are  specified.  More 
details  about  the  module  can  be  found  in  the  MDB-11C  module  Instruction 
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BOARD  PINS  ASSIGNMENT 


Pin  # 

Signal 

Pin  # 

1 

+5V 

37 

2 

S 

38 

3 

R 

39 

4 

P 

40 

5 

N 

41 

6 

M 

42 

7 

L 

43 

8 

K 

44 

9 

J 

45 

10 

H 

46 

11 

G 

47 

12 

F 

48 

13 

E 

49 

14 

D 

50 

15 

C 

51 

16 

B 

52 

17 

A 

53 

18 

R0D15L 

54 

19 

ROD 14 L 

55 

20 

RV4U 

56 

21 

R0D12L 

57 

22 

RV4L 

58 

23 

RV3U 

59 

24 

RV3L 

60 

25 

RV2U 

61 

26 

RV2L 

62 

27 

RV1U 

63 

28 

RV1L 

64 

29 

ROD11L 

65 

30 

ROD13L 

66 

31 

RP 

67 

32 

SR 

68 

33 

SP 

69 

34 

PWL 

70 

35 

RODOIL 

71 

36 

RODOOL 

72 

Signal 

Pin  I 

Signal 

SHIFTL 

73 

LP 

ROD04L 

74 

MR 

ROD05L 

75 

MP 

ROD06L 

76 

NR 

DA02L 

77 

NP 

DA03L 

78 

PR 

DVCL 

79 

PP 

U5G 

80 

RR 

EOMS 

81 

ROD09L 

U6G 

82 

ROD08L 

83 

RODIOL 

+28V 

84 

R1V 

-28V 

85 

R5 

GND 

86 

R1H 

+5V 

87 

R6 

AR 
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R0D02L 

AP 

89 

R0D03L 

BR 

90 

R0D07L 

BP 

91 

DAOrL 

CR 

92 

DA05L 

CP 

93 

EOML 

DR 

94 

DA01L 

DP 

95 

DAOOL 

ER 

96 

R2V 

EP 

97 

R8 

FR 

98 

R2H 

FP 

99 

R7 

GR 

100 

GND 

GP 

HR 

HP 

JR 

JP 

KR 

KP 

LR 

APPENDIX  D 

SOFTWARE  DOCUMENTATION 


PROGRAM  C 


Purpose:  To  print  the  current  (X,Y)  cursor  size. 

Usage  under  OS. 

Type:  C  or  <?C 

Author:  Marvin  Brown 

System-Language:  ADVISAR  -  FTN4 

Routines  Used:  RMPAR,  FRCUR,  LURQ,  CLTTY,  EXIT 

Example:  >C 

> CURSOR  SIZE  (X,Y)  -  103,  27 
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PROGRAM  CLMEM 


Purpose: 

To  set  a  frame  to  a  given  value. 

Usage: 

under  RTE  11  or  FRGR:  RU,  CLMEM,, f,u 

under  OS:  @CLMEM  or  *RU, CLMEM, ,f ,n 
where  -  f  *  the  frame  to  be  cleared 

u  »  two  times  the  value  that  is  to  be  in  the  frame. 

note  -  when  using  the  @  under  OS,  -  f  is  the  frame  being  displayed 

on  the  RED  signal  system 
-  n  is  the  X  cursor  position. 


Author : 

Marvin  Brown 

System- Language : 

ADV I SAR-FTN4 

Routines  Used: 

RMPAR,  LAND,  MEMIO,  EXIT 


Example 


PROGRAM  COPY 


Purpose: 

To  copy  data  between  mag  tapes. 

Usage: 

Under  RTE  II  or  FMGR 

RU,  COPY,  mode,  fr,  lul,lu2,u 

Where:  mode  •  B  for  binary  or  C  for  coded 
fr  •  F  for  files  or  R  for  records 
lul  “  where  the  data  Is  coming  from 
lu2  “  where  the  data  is  going  to 

u  “  the  number  of  transfers  to  be  performed 

Author: 

Marvin  Brown 

System-Language : 

RTE  II  -  FRN4 

Routines  Used: 

RMPAR,  EXEC,  I SUNT,  REIO,  EXIT 
Example: 

RU,  COPY,  B,  R,  13,  8,  5 

Copies  five  binary  records  from  9-track  1600  BPI  to  the  UP  7-track 
drive. 


PROGRAM  D 


Purpose: 

To  oucpuc  che  data  value  from  Che  current  frame  at  the  current  cursor 
location. 

Usage : 

Under  RTE  II  or  FMGR 
RU,  D,,f,x,y 

Under  OS 

D  or  @D  or  *RU,D,,f,x,y 

Where:  f  -  the  frame  to  interrogate 
x  -  the  x  position 
y  -  the  y  position 

Note:  under  OS  using  D  or  @D,  the  current  frame  is  the  frame  on  the 
RED  signal  system  and  x,y  is  the  current  cursor  position. 

Author : 

Marvin  Brown 

Systemr Language : 

ADVISAR-FTN4 

Routines  Used: 

RMPAR,  FRCUR,  MEMIO,  LURQ,  CLTTY  EXIT 

Example:  *D 

•>DATA  VALUE  -  127 


PROGRAM  DC 


Purpose: 

This  program  prompts  for  cursor  parameters.  Cursor  position,  size, 
type  and  color  can  be  set. 

Usage: 

Under  RTE  II  or  FMGR 
RU,  DC 
Under  OS 
@DC 

Note:  -  null  parameter  entered  do  not  change  that  parameter  of  the 
cursor 

-  cursor  position  and  size  flags  are  turned  off. 

Author : 

Marvin  Brown 

System- Language : 

ADVISAR  -  FTN4 

Routines  Used: 

FMPAR  LUCON,  RSCOM,  LURQ,  CLTTY,  WSCOM,  EXIT 

Example: 

>@DC 

> ENTER  x,  y  POSITION  (0-511,  0-511)  -  100,  110 
> ENTER  x,  y  SIZE  (0-511,  0-511)  -  21,  54 
> ENTER  type  (0-8),  BW  (0-4),  RGB  (0-8)  -  1,  3,  4 


PROGRAM  DEMO 


Purpose: 

This  program  transfers  frame  file(s)  from  9-track  1600  BPI  tape  to 
memory  frame (s). 

Usage: 

under  RTE-II  or  FMGR 
RU,  DEMO, ,f ,n 

under  OS 

@DEMO  or  *RU , DEMO , , f , n 

where:  f  “  the  first  frame  to  be  transferred  to 
n  *  the  number  of  frames  to  transfer 

note:  -  in  OS,  if  @D£MO  is  typed,  the  current  frame  which  is  being 
displayed  on  the  RED  signal  system  is  used  for  f.  Also,  n 
is  one. 

-  default  values  for  f  and  n  are  0  and  8,  respectively  if  RU, 
DEMO  is  used. 

Author : 

Marvin  Brown 

System-Language : 

ADVISAR-FTH4 

Routines  Used: 

RMPAR,  WSCOM,  BFINP,  ISUNT,  MEMIO,  EXIT 


Example : 
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PROGRAM  DF 


Purpose: 

To  prompt  for  any  display  frame  changes. 

Usage: 

Under  OS: 

@DF 

Note:  -  null  parameters  entered  do  not  change  the  frame  displayed. 

-  current  display  frames  are  U6ed  and  output  with  the  prompt. 

-  see  also  DFO  for  overlay  frames  and  turning  on  or  off  a 
signal  system. 

Author : 

Marvin  Brown 

System-Language : 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  FRCUR,  LURQ,  CLTTY,  RSCOM,  WSCOM,  EXIT 

Example: 

>@DF 

> ENTER  DISPLAY  FRAMES  -  (0,1, 2, 2, 3)  -  ,,1,1 
>@DF 

> ENTER  DISPLAY  FRAMES  -  (0,1, 1,1,3)  -  1,1, 1,1,1 
> 
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PROGRAM  DFO 


Purpose: 

To  prompt  for  any  frame  or  overlay  changes. 

Usage : 

Under  RTE  II  or  FMGR: 

RU.DFO 

Under  OS: 

@DFO 

Note:  -  the  signal  systems  to  be  changed  are  prompted  for. 

-  all  signal  systems  are  changed  In  the  same  way. 

-  the  current  setup  of  the  first  signal  system  entered  is  out¬ 
put  in  the  prompt. 

Author: 

Marvin  Brown 

System  Language: 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  LUCON,  LURZ,  CLTTY,  MOD,  RSCOM,  LAND,  1SHFT ,  10R,  WSCOM,  EXIT 
Example: 
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PROGRAM  DIG 


Purpose:  To  digitize  a  picture  and  transfer  it  into  the  Intel  memory. 


Usage:  under  RTE-II  or  FMGR 

RU,  DIG, , f 
under  OS 

<3DIG  or  *RU ,  DIG, , f 

where:  f  "  the  frame  to  be  transferred  to 

note:  in  OS,  if  @DIG  is  typed,  the  current  frame  which  is  being 

displayed  on  the  RED  signal  system  is  used  for  f. 


Author:  Marvin  Brown 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  I AND,  LODXY,  EXEC,  MEMIO,  EXIT 
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PROGRAM  DLP 

Purpose: 

To  prompt  for  loop  parameters.  The  parameters  Include  loop  key,  number 
of  frames  In  the  loop,  loop  rate,  dwell  and  the  loop  sequence. 

Usage : 

Under  RTE  II  or  FMGR: 

RU,  DLP 

Under  OS: 

@DLP 

Note:  null  parameter  entered  do  not  change  that  parameter. 

Author: 

Marvin  Brown 

System-Language : 

ADVISAR-FTN4 

Routines  Used: 

RMPAR,  LUCON,  LURQ,  CLTTY,  MOD,  RSCOM,  EXIT 

Example: 

>@DLP 

> ENTER  SIGNAL  SYSTEM(S)  -  (0-4)  -  0,3 
>KEY  COUNT  RATE  DWELL  12345678 
>0  8  10  5  01234567 

>-.,5,2 
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PROGRAM  DSCR 


Purpose: 


To  interrogate  and  prompt  for  the  current  linage  screen  position. 


Usage:  under  RTE-II  or  FMGR  - 

RU,  DSCR 
under  OS 
@DSCR 

Note:  screen  coordinates  are  bounded  by  0  and  511. 


Author: 

Marvin  Brown 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 


RMPAR,  LUCON,  RSCRN,  LURQ,  CLTTY,  BOUND,  WSCRN,  EXIT 


EXAMPLE : 

>6DSCR 

>ENTER  START  X*  END  X*  START  Y *  END  Y 
0  511  0  511 

><?DSCR 

>ENTER  START  X,  END  X*  START  Y*  END  Y 
100  200  100  200 

><?DSCR 

>ENTER  START  X*  END  Xt  START  Y»  END  Y 
400  511  100  200 

>eoscR 

>ENTER  START  X*  END  X*  START  Y»  END  Y 
400  511  0  511 

>0DSCR 

>ENTER  START  Xt  END  Xt  START  Y»  END  Y 
0  511  0  511 

> 

> 

> 

> 

> 

> 

> 
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-  10Q # 200 » 100*200 

-  400  600 

-  **0*511 

-  0 
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PROGRAM  EQ 


Purpose : 


To  prompt  for  parameters  to  define  a  signal  system  enhancement. 


Usage: 

Under  RTE-II  or  FMGR  - 
RU,  EQ 
Under  OS  - 
@EQ 


Note:  -  parameters  are  prompted  for  until  an  Illegal  signal  system  is 
entered 

-  parameters  are  described  later. 


Author: 

Marvin  Brown 

Sys tern- Language : 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  LUCON,  LURQ,  CLTTY,  EXEC,  BOUND,  FLOAT,  ALOG,  EXP,  ENHEO, 
IF  IX 


ki  tr  JW 
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EQ  Parameter  description 

(IEN,  IBZ,  IEZ,  IFUNC,  ILZ,  IHZ,  NSP,  IBS,  IES) 


IEN  “  The  signal  system  to  define. 

IBZ  -  The  starting  value  to  be  ehanhced 

IEZ  -  The  ending  value  to  be  enhanced 
IFUNC  ”  The  enhancement  function 

*  0  a  linear  function,  i.e.  IFUNC  (IBZ)  -  IBS 
linear  to  IFUNC  (IEZ)  -  IES 

>  0  then  exponential  between  IBZ  and  IEZ.  This  highlights 
numbers  close  to  IEZ  (bright  areas) 

<  0  then  a  logarithmic  function  is  used  on  values  between 
IBZ  and  IEZ.  This  highlights  numbers  close  to  IBZ 
(dark  areas) 

ILZ  ■  The  value  to  which  the  input  values  less  than  IBZ  are  set. 

IHZ  <*  The  value  to  which  the  input  values  greater  than  IEZ  are  set. 

NSP  -  The  number  of  steps  output  that  are  In  the  enhancement 
between  IBZ  and  IEZ. 

IBS  -  The  value  output  when  a  lookup  is  done  on  IBZ. 

IES  "  The  value  output  when  a  lookup  is  done  on  IEZ. 


k 
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PROGRAM  EV 


Purpose: 

To  define  enhancement  segments 


Usage: 

Under  RTE-II  or  FMGR  - 
RU,  EV 
Under  OS, 

(?EV 

Note:  The  parameters  are  prompted  for  until  an  Illegal  signal 
system  Is  entered. 


Author: 

Marvin  Brown 

Sy s  t  em- Language : 

ADVISAR  -  FTNA 
Routines  Used: 


RMPAR,  LUCON,  NHVCV,  EXEC,  LLRQ,  CLTTY,  BOUND,  IFIX,  FLOAT,  INHIO 


INPUT  TO  TTY 

0,  0  60,  25,  125 
0,  61,  125,  125,  125 
0,  126,  175,  125,  0 
0,  250,  255,  250,  0 
9 


COMMENTS 

SEGMENT  a 
SEGMENT  b 
SEGMENT  c 
SEGMENT  d 

TERMINATE  SEQUENCE 


NOTE:  SEGMENT  e  COMES  FROM  ORIGINAL  ENHANCEMENT  CURVE 


PROGRAM  JOYZM 


Purpose: 

To  enlarge  the  dace  contained  in  the  dursor  to  the  full  size  of  another 
f  rame . 

Usage: 

Under  OS: 

0JOYZM 

Note:  -  JOYZM  prompts  for  a  frame  to  write  into. 

-  the  current  frame  being  displayed  on  the  RED  signal  system  is 
enlarged 

-  the  current  position  and  size  of  the  cursor  is  used  for  the  zoom. 

Author: 

Marvin  Brown 

System  Language: 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  LUCON,  LAND,  IABS,  FLOAT,  INT,  LURQ,  CLTTY,  EXIT,  MEM 10 

Example : 

>@ JOYZM 

>ZOOM  FRAME  0  TO  -7 
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PROGRAM  MOVE 


Purpose.  To  transfer  a  frame  to  another  frame  in  the  Intel  memory. 


Usage:  under  RTE  or  FMGR 

RU,  MOVE, ,rf 
Under  OS 

0MOVE  or  *RU,  MOVE,,f 
Where:  f  "  the  frame  to  transfer  from. 

Mote:  -  MOVE  prompts  for  the  destination  frame 

-  in  OS,  if  @MOVE  is  typed,  the  current  frame  which  is  being 
displayed  on  the  RED  signal  system  is  used  for  f. 

-  if  an  illegal  frame,  is  entered  or  *BR,MOVE  is  typed,  MOVE 
is  aborted. 


Author : 


Marvin  Brown 


System- Language: 

ADVISAR  -  FTN4 
Routines  Used: 

RMPAR,  LUCON,  I AND,  LURQ,  CLTTY,  MEMIO,  IFBRU,  EXIT 
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PROGRAM  N 


Purpose: 

To  initialize  the  ADVISAR  system.  The  frame  looping  is  reset,  the 
cursor  is  reset,  and  the  enhancement  tables  are  set  to  their  locations 
(l.e.  a  linear  enhancement). 

Usage: 

Under  RTE  II  or  FMGR: 

RU,  N 

Under  OS 
N 

Note: 

Cursor  size  and  position  keys  are  turned  off. 

Author : 

Marvin  Brown 

System- Language : 

ADVISAR  -  FTN4 

Routines  Used: 

WSCOM,  ENHIO,  MEMIO,  EXIT 

Example: 


t 
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PROGRAM  NRMLZ 


Purpose:  To  normalize  Che  digitizing  system. 


Usage:  Under  RTE-II  or  FMGR 

RU,  NRMLZ 
Under  OS 
<a  NRMLZ 

Note:  The  user  is  prompted  to  perform  tasks  (see  example) 


Author:  Marvin  Brown 


System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  LURQ,  CLTTY ,  SITUS,  KEYIN,  AJSET,  LDZRO,  LDRNG,  CRSXY, 
CLOSS,  AJZRO,  LODXY,  SAMPL,  QCALD,  EXIT,  EXEC,  LDSEF,  DIGUL, 
IUNPK,  IABS,  FLOAT 
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PROGRAM  0S 

Purpose:  This  program  provides  a  convenient  interface  between  the  user  and 
various  image  manipulation  routines,  navigation  programs  and  the  RTEII 
operating  system.  Three  basic  command  types  are  available  for  the  user. 

One  letter  keystrokes  activate  immediate  image  routines  such  as  setting 
the  looping  flag,  controlling  the  cursor,  and  printing  out  single  data 
values.  0S  can  also  initiate  more  complex  programs  if  the  program  name 
is  prefixed  by  an  @  key.  Examples  are  five  manipulation,  navigation  and 
graphic  output.  If  an  *  la  pressed,  then  any  RTEII  command  can  be  entered. 
Any  program  that  is  running  can  be  Btopped  using  this  command  by  typing 
*  BR,  program  name  or  *0F,  program  name. 

To  run  under  TREII  or  FMGR,  Type:  RU.0S 
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ONE  LETTER  KEYINS 


LETTER 

TYPE 

FUNCTION 

A 

Int 

Advances  frame  position 

B 

Int 

Backs  up  frame  position 

C 

Ext 

Print  cursor  size 

0 

E 

Ext 

Print  data  value 

F 

G 

H 

I 

J 

K 

Int 

Select  cursor  color 

Ext 

Print  loop  parameters 

L 

M 

N 

Int 

Start  and  stop  loop 

Ext 

Initialize  display 

0 

Int 

Select  cursor  type 

P 

Int 

Start  and  stop  position  joystick 

Q 

Int 

Return  to  RTE 

R 

Int 

Reset  to  beginning  of  loop 

S 

Int 

Start  and  stop  size  joystick 

T 

Ext 

Print  TV  coordinate 

U 

V 

w 

X 

Y 
Z 


f 
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Name 

CLMEM 

DC 

DEM 

DF 

DFO 

DLP 

JOYZM 

SCOM 

SDEMO 

VIDIO 


@  Programs 

Description 

Clear  the  displayed  memory. 

Prompt  for  cursor  parameters. 

Transfer  a  frame  file  to  a  frame. 
Prompt  for  display  frame  parameters. 
Prompt  for  frame  overlay  parameters. 
Prompt  for  loop  parameters. 

Enlarge  the  data  in  the  cursor. 

Read  and  write  ADVISAR  system  common. 
Save  a  frame  file  on  mag  tape. 

Change  the  video  output  format. 

Do  joystick  enhancement. 


ENHCE 
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Errors: 

1)  if  a  one  lecter  key  in  is  not  defined,  it  is  either  ignored  and 
another  prompt  is  output  (i.e.  7  #  7  where  #  was  the  undefined 
character.)  or  "NO  SUCH  PROG"  is  printed. 

2)  if  an  @  program  has  been  called  and  the  program  is  not  under  the 
RTE  II  system,  "NO  SUCH  PROG"  is  displayed. 

3)  if  an  RTE  II  command  is  entered  with  an  *  ,  then  RTEII  errors  are 
output. 
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Author: 

Marvin  Brown 

System-Language: 

ADVISAR  FTN4 

Routines  Used: 

RMPAR,  LUCON,  VURQ,  EXEC,  REIO,  DEUBU,  ISHFT,  RSCOM,  IOR,  LAND,  MESSS, 
WSCOM. 

Internal  Routines: 

INITO,  KINTR,  CRPAR,  RUNPR,  FRCON,  ROTCO,  LOOPC,  ROTTP,  JOYST,  QUIT,  JOYS, 
AT,  COLON,  STAR. 

Core-Timing: 


Examples: 
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PROGRAM  BFUNC 

Purpose:  This  program  does  define  f inary  frame  operations  on  two  frames 

and  writes  the  result  in  a  third  frame.  The  presently  defined  operations 

are:  AV  -  the  point  average. 

DF  -  the  point  difference. 

MN  -  the  point  minimum. 

MX  -  the  point  maximum. 

To  run  under  RTE  II  or  RMGR,  type:  RU,  BFUNC, ,fn,fl,f2,fw 
or  under  OS,  type:  *RU,  FBUNC, ,fu,f l,f2,fw 

where  -  fn  *  the  two  letter 
fl  -  the  first  frame 
f2  “  the  second  frame 
(in  DF,  fw»f 1-f 2) 
fw  ■  the  frame  to  be  written 
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Author: 

Marvin  Brown 

System- Language: 

ADVISAR-FTN4 

Routines  Used: 

RMPAR,  LUCON,  I AND,  CRSRC,  LURQ,  CLTTY,  EXIT,  WSCOM,  MEMIO,  ISHFT, 
MINO,  MAXO,  IFBRU 

Core-Timing: 


Examples: 
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PROGRAM  PSHFT 


Purpose: 


To  shifc  an  image  within  the  current  image  screen. 


Under  RTE-II  or  FMGR 
RU,  PSHFT,, f 
Under  OS 

@PSHFT  or  *RU,  PSHFT,, f 

Where:  f  *  the  frame  containing  the  image  to  be  shifted. 

Note:  -  see  DSCR  for  defining  the  current  image  screen. 

-  in  OS,  if  @PSHFT  is  typed,  the.  current  frame  which  is  being 
displayed  on  the  RED  signal  system  is  used  for  f. 

-  the  amount  to  shift  in  the  x  and  y  direction  are  prompted 
for 

-  both  positive  x  and  y  indicate  a  shift  down  and  right 


Author: 

Marvin  Brown 

Sy s  cem- Language : 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  LUCON,  I AND,  LURQ,  CLTTY,  RSCRN ,  IABS,  MEM10,  IFBRK,  EXIT 
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PROGRAM  RW7 


Purpose: 

To  rewind  the  7-track  tape  drive  and  reset  the  current  position. 


Usage : 

Under  RTE-II  or  FMGR 
RU,  RW7 
Under  OS 
@RW7 


Author: 

Marvin  Brown 

System- Language: 

ADVISAR  -  FTN4 
Routines  Used: 


WCUR7,  EXIT 
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0 

PROGRAM  RW9 


Purpose: 

To  rewind  the  9-track  tape  drive  and  reset  the  current  position. 


Usage: 

Under  RTE-II  or  FMGR 
RU,  RW9 
Under  OS 
@RW9 


Author: 

Marvin  Brown 

System- Language: 

ADVISAR  -  FTNA 
Routines  Used: 


WCUR9,  EXIT 
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PROGRAM  SCOM 


Purpose: 

To  read  and  wrlce  the  ADVISAR  system  common  area. 

Usage: 

Under  RET  II  or  FMGR: 

RU,  SCOM 

Under  OS: 

@SCOM 

Note: 

read  and  write  key,  common  location  and  value  are  prompted  for. 

Author: 

Marvin  Brown 

Sys tem- Language : 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  LUCON,  LURQ,  CLTTY,  RSCOM,  WSCOM,  EXIT 

Example: 

><?SCOM 

> ENTER  KEY  (1-READ,  2-WRITE),  LOCATION,  VALUE  -1,5 
> LOCATION  5  CONTAINS  0 


> 


■ 
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PROGRAM  SDEMO 


Purpose: 

This  program  transfers  a  frame  from  memory  to  a  frame  file  on  9-track 
1600  BPI  tape. 

Usage: 

Under  RTEII  or  FMGR: 

RU,  SDEMO,, f 

Under  OS 

0SDEMO  or  *RU,  SDEMO,, f 
Where: 

f  -  the  frame  to  be  transferred  to  mag  tape. 

Note: 

-  in  OS,  f  is  lnterperated  as  the  current  frame  being  displayed  on 
the  RED  signal  system. 

-  see  DEMO  for  restoring  a  frame  file. 

Author: 

Marvin  Brown 

System- Language : 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  LAND,  MEMIO,  BFOUT,  EXIT 


Example: 


PROGRAM  SKIP 


Purpose: 

To  provide  convenient  mag  tape  manipulation. 

Usage : 

Under  RTE  II  or  FMGR: 

RU,  SKIP,  fr,  mt,  n 

Under  OS: 

*RU,  SKIP,  fr,  mt,  n 
Where: 

fr  “  F  or  R  for  flies  or  records,  respectively, 
mt  *  the  logical  unit  number  of  the  mag  tape, 
n  “  the  number  of  files  to  skip.  (Negative  is  backwards,  aero 
skips  to  the  beginning  of  the  file). 


Errors: 

If  neither  F  or  R  are  the  first  parameter,  an  error  message  is  output. 

Author: 

Marvin  Brown 

System- Language : 

ADVISAR  -  FTN4 


Routines  Used: 

SKPFL,  RMPAR,  IABS,  EXEC 


Example: 
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PROGRAM  T 


i 

Purpose:  j 

To  print  the  current  x,  y  location  of  the  center  of  the  cursor  on 
the  screen. 

Usage: 

Under  OS: 

T  or 

Author : 

Marvin  Brown 

System-Language: 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  FRCUR,  LURQ,  CLTTY,  EXIT 

Example: 

>T 

> CURSOR  POSITION  (x,  y)  -  500,  217 
> 


A 


35 


PROGRAM  TLIST 


Purpose: 

To  print  file  and  record  information  for  a  mag  tape. 
Usage: 

Under  RET  II  or  FMGR: 

RU,  TLIST, ,mt,nf,fg 

Where: 

mt  »  the  mag  tape  logical  unit 
nf  *  the  number  of  files  to  go  through 
fg  -  0  then  print  all  record  information. 
j1  0  then  print  only  the  file  information. 

Author: 

Marvin  Brown 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR  EXEC,  I SUNT 


Example: 
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PROGRAM  T7 


Purpose:  To  read  an  image  from  the  7  track  tape  drive  in  external  format 
and  store  it  in  the  current  image  screen  (see  DSCR)  in  the  Intel 
memory. 


Usage : 

Under  RTE-II  or  FMGR 
RU,  T7 
Under  OS 
@T7 

Note:  -  file,  records  and  elements  are  prompted  for. 

-  if  an  end  of  file  is  encountered,  the  number  of  records 
in  the  file  is  output. 

-  if  a  negative  file  or  record  is  entered,  the  T7  is 
aborted. 


Author: 

Marvin  Brown 


System- Language: 

ADVISAR  -  FTN4 


Routines  Used: 


RMPAR,  PICTR,  EXIT,  RCUR  7,  SKPFL,  BFINP,  ISUNT,  PTAPE,  LENGT, 
RDREC,  WCUR  7 
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PROGRAM  T7HP 


Purpose : 

T >  read  an  image  from  the  7  track  tape  drive  in  HP  format  and  store 
it  in  the  current  image  screen  (see  DSCR)  in  the  Intel  memory. 


Usage : 

Under  RTE-II  or  FMGR 
RU,  T7HP 
Under  OS 
@T7HP 

Note:  -  file,  records  and  elements  are  prompted  for. 

-  if  an  end  of  file  is  encountered,  the  number  of  records  in 
the  file  is  output. 

-  if  a  negative  file  or  record  is  entered,  the  T7HP  is  aborted 


Author : 

Marvin  Brown 


System- Language: 

ADVISAR  -  FTN4 
Routines  Used: 

RMPAR,  PICTR,  EXIT,  RCUR7,  SKPFL,  BFINP,  ISUNT,  PTAPE,  LENGT, 
RDREC,  WCUR7 
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PROGRAM  T9L 


Purpose.  read  an  image  from  Che  9  track  tape  drive  at  800  BPI  and  store 
it  in  the  current  image  screen  (see  DSCR)  in  the  Intel  memory. 


Usage : 


Under  RTE-II  or  FMGR 
RU,  T9L 
Under  OS 
@T9L 


Note:  -  file,  records  and  elements  are  prompted  for. 

-  if  an  end  of  file  is  encountered,  the  number  of  records  in 
the  file  is  output. 

-  if  a  negative  file  or  record  is  entered,  the  T9L  is  aborted. 


Author: 


Marvin  Brown 


System- Language : 

ADVISAR  -  FTN4 
Routines  Used; 

RMPAR,  PICTR,  EXIT,  RCUR9,  SKPFL,  BFINP,  ISUNT,  PTAPE,  LENGT, 
RDREC,  WCUR9 
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PROGRAM  T9H 


Purpose:  fo  reaci  an  image  from  the  9  track  tape  drive  at  1600  BPI  and  store 
it  in  the  current  image  screen  (see  DSCR)  in  the  Intel  memory. 


Usage : 

Under  RTE-II  or  FMGR  - 
RU,  T9H 
Under  OS 
@T9H 


Note:  -  file,  records  and  elements  are  prompted  for 

-  if  an  end  of  file  is  encountered,  the  number  of  records  in 
the  file  is  output. 

-  if  a  negative  file  or  record  is  entered,  the  T9H  is  aborted. 


aucnor:  Marvin  Brown 

System- Language : 

ADVISAR  -  FTN4 

Routines  Used: 

RMPAR,  PICTR,  EXIT,  RCUR9 ,  SKPFL,  BFINP,  ISUNT,  PTAPE,  LENGT ,  RDREC, 
WCUR9 


1 

L 
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PROCRAM  VIDIO 


Purpose: 

To  change  between  the  480  and  512  vidio  line  display  format.  Vidio 
tapes  can  only  be  made  in  480  line  format. 

Usage: 

Under  RTE  II  or  FMGR: 

RU,  VIDIO 

Under  OS: 

@VIDI0 

Note: 

VIDIO  takes  3  seconds  to  run;  this  is  for  hardware  stabilization. 

Author: 

Marvin  Brown 

System-Language : 

ADVISAR  -  FTN4 

Routines  Used: 

RSCOM,  WSCOM,  WAIT S,  EXIT 
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SUBROUTINE  CLFRM 


Purpose: 

To  set  each  location  in  a  frame  to  a  given  value. 
Usage: 

CALL  CLFRM  (IF,  IUAL) 

Where: 

IF  »  the  frame  number  (0-7). 

IVAL  »  the  value  to  which  the  frame  is  set  (0-255) 

Author: 

Marvin  Brovm 

Sys  tem- Language : 

RTE  II  -  ASMB 

Routines  Used: 

EXEC,  calls  the  program  CLMEM 
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SUBROUTINE  COLOR 


Purpose:  To  set  the  value  for  plotting  routines  to  write. 


Usage:  CALL  COLOR  (IVAL) 

•  .  <  «  .Where:  IVAL  -  the  eight  bit  value  (0-255)  for  all  plotting  routines 

to  write 


Author:  Mark  Whitcomb 


System-Language: 

ADVISAR,  FTN4 


Routines  Used: 

WPCOM,  entry  point  in  PCOM 
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SUBROUTINE  DASH 


Purpose:  To  set  the  dash  line  mode  for  line  and  vector  plotting  routines 


Usage:  CALL  DASH  (IDASH) 

.  Whe*e:.. -IDASH.  is.  a  4  word.  Use  as  arsay  •aatiMinlag  tha«daab*pat*cwi  -- 
IDASH  (1)  “  Number  of  bits  on 

IDASH  (2)  “  Number  of  bits  off 

IDASH  (3)  “  Number  of  bits  on 

IDASH  (4)  ”  Number  of  bits  off 

Note:  to  reset  dash  mode  to  fall  lines,  set  IDASH  (1) 

or  IDASH  (3)  to  any  integer  >  zero  and  set  IDASH  (2) 
and  IDASH  (4)  to  zero. 


Author:  Mark  Whitcomb 


System- Language: 

ADVISAR,  FTN4 

Routines  Used: 

WPCOM,  an  entry  point  in  PCOM 
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SUBROUTINE  ENHIO 


Purpose : 

To  read  or  write  the  enhancement  tables. 


Usage: 


CALL  ENHIO  (KEY,  IS,  IP,  IBUF,  LBUF) 


Where: 


KEY 

IS 


IP 

IBUF 

LBUF 


-  1  for  read  enhancement  table 

-  2  for  write  enhancement  table 
“  signal  system  (0-4) 

0  -  red,  1  -  green,  2  “  blue,  3  -  B/Wl,  4  -  B/W2 
«  first  enhancement  location  to  read  or  write 

-  enhancement  buffer  (unpacked  8-bit  bytes) 

-  number  of  enhancement  values 


Author: 

Marvin  Brown 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

IAND,  LURQ,  EXEC,  MOD 
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SUBROUTINE  FRAME 


Purpose:  To  set  the  frame  number  for  all  plotting  routines  to  write  to. 

Usage:  CALL  frame  (IFR) 

Where:  IFR  »  integer  frame  number  (0-7) 


Author: 


Mark  Whitcomb 


System- Language : 


ADVISAR,  FTN4 
Routines  Used: 


WPCOM,  an  entry  point  in  PCOM 
I  AND 
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SUBROUTINE  FRMOV 


Purpose : 


To  transfer  an  entire  frame  to  another  frame 


Usage: 


CALL  FRMOV  (IFR,  IFW) 


Where:  IFR  »  frame  to  read  from 
IFW  -  frame  to  write  to 


Author : 


M.  Brown 


System- Language: 


ADVISAR  -  FTN4 
Routines  Used: 

EXEC,  program  MOVE 
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SUBROUTINE  LINE 


Purpose;  to  plot  a  line  to  a  frame  in  the  memories. 


Usage:  CALL  LINE  (IX I,  IY1,  1X2,  IY2) 

Where:  1X1  •  integer  X  coordinate  of  starting  point  (0*511) 

IY1  »  integer  Y  coordinate  of  starting  point  (0-511) 

1X2  ■  integer  X  coordinate  of  ending  point  (0-511) 

IY2  “  integer  Y  coordinate  of  ending  point  (0-511) 

Note:  Out  of  range  (0-511)  values  are  legal,  but  only  points  lying 

between  (0-511)  are  plotted.  Actual  line  includes  all  points 
in  between  (1X1,  IY1)  and  (1X2,  IY2),  including  (1X2,  IY2) 
but  excluding  (1X1,  IY1). 

Line  is  drawn  conforming  to  line  width,  dash  pattern  and  value 
as  set  by  other  routines  (WDTH,  DASH,  COLOR).  Default  values 
are:  width:  1 

dash:  full  line, 
value:  255 

The  plot  pointer  is  set  to  (1X2,  IY2) 


Author:  Mark  Whitcomb 


System- Language: 

ADVISAR,  FTN4 

Routines  Used: 

RPCOM,  WPCOM,  entry  points  in  PC0M,  IABS,  SQRT,  PSTRT,  PQUIT,  PLINE, 
PDASH 
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FUNCTION  MASK  (MASK) 


Purpose : 

To  set  refresh  memory  mask. 


Usage : 

CALL  MASK  (IMASK) 

Where:  IMASK  -  8-bit  memory  mask  (0-25 j) 

Note:  if  IMASK  -  0  then  the  current  mask  value  is  returned. 


Author : 

Marvin  Brown 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

I  AND 
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SUBROUTINE  MEMIO 


Purpose:  fo  rea£j  antj  write  an  Intel  memory  frame. 


Usage: 

CALL  MEMIO  (KEY,  IF,  IROW,  ICOL,  IBUF,  LBUF) 

Where:  KEY  ■  1  for  reading  the  memory 
*  2  for  writing  the  memory 
IF  ■  frame  to  read  or  write  (0-7) 

IROW  »  row  position  to  start  transfer  (0-511) 

ICOL  »  column  position  to  start  transfer  (0-511) 

IBUF  *  data  buffer  (unpacked  8-bit  bytes) 

LBUF  -  number  of  values  to  transfer 

Note:  Values  are  transferred  Incrementing  the  column  counter  then 

the  row  counter. 


Author : 

Marvin  Brown 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

I AND,  ISHFT,  LURQ,  EXEC 


Subroutine  MOV 


Purpose.  To  move  the  plotting  pointer  (for  Vector  routines)  to  a  specified 
point. 


Usage;  CALL  MOV  (IX,  IY) 

Where:  IX  -  integer  X  location  in  frame  (0-511) 

IY  -  integer  Y  location  in  frame  (0-511) 

Note;  a  point  lying  outside  the  range  (0-511)  is  legal,  however, 

no  points  can  be  plotted,  since  it  lies  off  the  screen. 


Author: 


Mark  Whitcomb 


System- Language: 


ADVISAR,  FTN4 


Routines  Used: 

WPCOM,  an  entry  point  in  PCOM 
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SUBROUTINE  MOVR 


Purpose.  aet  t^e  plotting  pointer  (for  vector  routines)  to  its  previous 
position  plus  relative  corrdinates. 


Usage:  CALL  M0VR  (IX>  IY) 

Where:  IX  *  integer  increment  in  X  direction 
IY  "  integer  increment  in  Y  direction 

Note:  IX,  IY  can  be  any  legal  integers.  Pointer  is  set  exactly 

to  (OLDX  +  IX,  OLDY  +  IY).  If  resultant  pointer  is  off  screen, 
simply  no  points  can  be  plotted  there. 


Author: 


Mark  Whitcomb 


System- Language : 

ADVISAR,  FTN4 

Routines  Used: 

RPCOM,  WPCOM,  entry  points  in  PCOM 
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SUBROUTINE  MPNT 


Purpose.  To  output  a  singie  point  to  the  Intel  memories. 


Usage;  CALL  MPNT  (IX,  IY,  IVAL) 

Where:  IX  ■  integer  X  frame  coordinate  (0-511) 

IY  -  integer  Y  frame  coordinate  (0-511) 

IVAL  ■  8  bit  value  to  be  written 

Note:  The  lower  8  bits  of  IVAL  are  masked  off  to  be  written. 

If  IX  or  IY  are  out  of  the  range  (0-511),  no  point  is  written. 
Input  MUX,  output  MUX  and  control  buffer  are  assumed  to  be 
set  properly. 

This  routine  shuts  off  the  interrupt  system  to  do  the  output, 
waiting  for  its  completion. 


Author : 


Mark  Whitcomb 


System- Language: 

ADVISAR,  ASMB 
Routines  Used: 


. ENTR,  $LIBR,  $LIBX 
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PCOM 


Purpose : 


To  allow  direct  access  to  the  plot  common  area 


Entry  Points:  WPCOM:  write  plot  common 

RPCOM  (IWORD,  IDAT)  or  CALL  RPCOM  (IWORD,  1DAT) 

Where:  IWORD  ■  word  number  in  common  area 
IDAT  -  data  to  be  written  or  read 

Word  Arrangement: 

Word  0  “  frame  number 

Word  1  “  current  X  pointer  position 

Word  2  *  current  Y  pointer  position 

Word  3  *  dash  mode  flag 

Word  4  “  dash  code  1  (on  1) 

Word  5  “  dash  code  2  (off  1) 

Word  6  •  dash  code  3  (on  2) 

Word  7  ■  dash  code  4  (off  2) 

Word  8  -  color  (0-255) 

Word  10“  current  dash  position 
Word  11“  current  dash  count 


Author : 


Mark  Whitcomb 


System- Language: 


ADVISAR,  ASMB 
Routines  Used: 

.  ENTR 


SUBROUTINE  PDASH 


Purpose:  To  plot  a  single  width  dashed  line  to  a  frame  in  the  memories. 


Usage:  CALL  PDASH  (1X1,  IY1,  1X2,  IY2,  IDASH,  ID,  KOUNT  IVAL) 

Where:  1X1  »  starting  X  location 
IY1  -  starting  Y  location 
1X2  »  ending  X  location 
IY2  *  ending  Y  location 
IDASH  ■  4  word  array  with  dash  pattern 
ID  ■  current  subscript  in  IDASH 
KOUNT  »  current  dash  count 
IVAL  -  eight  bit  value  to  be  written 

Note:  X,  Y  locations  off  screen  are  Ignored.  A  dashed  line  is  drawn 
to  include  (1X2,  IY2)  but  to  exclude  (1X1,  1Y1). 

Assumption  is  made  that  memory  input  MUX,  control  buffer, 
etc.  are  properly  set. 


Author:  Mark  Whitcomb 

System- Language: 

ADVISAR,  FTN4 

Routines  Used: 

IABS,  ABS,  SQRT,  MPNT 
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SUBROUTINE  PLINE 


Purpose:  To  piot  a  aingie  width  line  to  a  frame  in  the  memories. 


Usage:  CALL  PLINE  (IX L,  IY1,  1X2,  IY2,  IVAL) 

Where:  1X1  »  starting  X  location 
IY1  »  starting  Y  location 
1X2  »  ending  X  location 
IY2  »  ending  Y  location 
IVAL  »  eight  bit  value  to  be  written 

Note:  X,  Y  locations  off  screen  are  ignored.  Line  is  drawn 

from  (1X1,  IY1)  to  (1X2,  IY2)  including  the  point  (1X2, 
but  excluding  the  point  (1X1,  IY1). 

Assumption  is  made  that  memory  input  MUX,  control  buffer 
etc.  are  properly  set. 


Author:  Mark  whited 

System- Language: 

ADVISAR,  FTN4 

Routines  Used: 

IABS,  MPNT 


IY2), 
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SUBROUTINE  PNT 


Purpose:  To  p^ot  a  8ingie  point  to  a  frame  in  the  memories. 


Usage:  CALL  PNT  (IX,  1Y) 

Where:  IX  ■  integer  X  coordinate 
IY  -  integer  Y  coordinate 

Note:  if  IX  or  IY  is  off  screen,  no  point  ia  written.  The  plot 

pointer  is  always  set  to  (IX,  IY). 


Author:  Mark  Whitcomb 

System- Language: 

ADVISAR  -  FTNA 

Routines  Used: 

RPCOM,  WPCOM,  entry  points  in  PCOM,  MPNT,  PSTRT ,  PQUIT 
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SUBROUTINE  PQUIT 


Purpose:  -jo  reset  the  memories  after  plotting. 


Usage :  CALL  PQUIT 


Author:  jfc,*  Whitcomb 

System- Language: 

ADVISAR  -  FTNA 

Routines  Used: 

EXEC.  LURQ 
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SUBROUTINE  PSTRT 


Purpose:  j.Q  set  Up  the  memories  for  plotting 


Usage :  CALL  PSTRT  (IFR) 

Where:  IFR  -  frame  number  to  plot  to  (0-7) 


Author:  Whitcomb 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

EXEC,  LURQ 
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SUBROUTINE  PSYM 


Purpose.  output  a  ,ioC  matrix  (characters)  to  a  frame  in  the  memories. 


Usage: 

CALL  PSYM  (IX,  IY,  MATC,  NC,  NR,  ISIZE,  IORNT,  IVAL) 

Where:  IX  *  integer  X  location  of  matrix  upper  left  hand  corner 

IY  -  integer  Y  location  of  matrix  upper  left  hand  corner 

MATC  -  linear  array  with  bit  pattern  of  dot  matrix 

NC  •  number  of  columns  in  dot  matrix  (dimension  of  MATC) 

NR  -  number  of  rows  in  dot  matrix  (number  of  bits  in  one 

word  -  right  justified,  must  be  less  than  or  equal  to  16) 

ISIZE  -  character  size 

1  -  matrix  size 

2  -  twice  matrix  size 

3  “  thrice  matrix  size,  etc. 

IORNT  -  character  orientation 

1  -  horizontal,  0  degrees 

2  -  vertical,  90  degrees 

3  -  horizontal,  180  degrees 

4  -  vertical,  270  degrees 
IVAL  -  8  bit  value  to  be  written 


Author:  Mark  whited 

System- Language: 

ADVISAR  -  FTN4 
Routines  Used: 

I AND,  ISHFT,  MPNT 
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SUBROUTINE  PWRT 


Purpose.  To  write  a  gtring  0f  alphanumeric  dot  matrix  characters  to  the 
memories. 


Usage : 

CALL  PWRT  (IX,  IY,  ICHAR,  NCHAR,  ISIZE,  IORNT) 

Where:  IX  -  integer  X  location  of  upper  left  hand  corner  of 
first  character 

IY  -  integer  Y  location  of  upper  left  hand  corner  of.  first 
character 

ICHAR  -  linear  array  of  packed  ASCII  characters  (Hollerith 
format) 

NCHAR  -  number  of  characters  in  ICHAR 
ISIZE  ■  character  size 

1*5x7  dot  matrix  (8x8  with  spacing) 

2  -  10  x  14  dot  matrix  (16  x  16  with  spacing) 

3  -  15  x  21  dot  matrix  (24  x  24  with  spacing),  etc. 
IORNT  -  character  orientation 

1  ■  horizontal,  Increasing  X  (0°) 

2  -  vertical,  decreasing  y  (90°) 

3  -  horizontal,  decreasing  X  (180°) 

4  *  vertical,  increasing  Y  (270°) 


Author: 


Mark  Whitcomb 


System- Language: 

ADVISAR  -  FTN4 
Routines  Used: 

RPCOM,  an  entry  point  in  PC0M 
I AND,  ISHFT,  PSTRT,  PQUIT,  PSYM 
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SUBROUTINE  RCURP 


Purpose : 


To  read  Che  current  cursor  position. 


Us.itjo:  CALL  RCURP  (IXj  IY) 


Where:  IX 
IY 


current  X  position  of  center  of  cursor  returned  (0-511) 
current  Y  position  of  center  of  cursor  returned  (0-511) 


Author:  M  Brown 

Sy s  t  em- Language : 

ADVISAR-FTN4 

Routines  Used: 

RSCOM 
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SUBROUTINE  RCURS 


Purpose: 


To  read  the  current  cursor  dimensions 


Usage: 


CALL  RCURS  (IXD,  I YD) 


Where: 


IXD  ■  current  X  dimension  of  cursor  returned  (0-511) 
IYD  ■  current  Y  dimension  of  cursor  returned  (0-511) 


Author: 

M.  Brown 

Sys  tem- Language : 

ADVISAR  -  FTNA 
Routines  Used: 

RSCOM 
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Purpose: 


SUBROUTINE  RCURT 


To  read  che  cursor  type  and  color  parameters 


Usage : 


CALL  RCURT  (ITYPE,  ICOLR,  IBW) 

Where:  ITYPE  *  cursor  type  key  returned  *  (0-8) 

ICOLR  -  cursor  color  returned**  (0-8) 

IBW  -  black  and  white  cursor  returned  ***  (0-4) 


*  cursor  types  are: 


0  ■  no  cursor 

1  •  solid  box 

2  "  box  outline 

3  ■  window 

4  “  windpw  with  box 

5  “  cross-hairs 

6  ■  four  corner  dots 

7  -  window  with  cross-hairs 

8  ■  window  with  fourcorner  dots 


Author: 


**cursor  colors: 


(more  on  back) 


M.  Brown 


0  •  flashing 

1  ■  black 

2  *  red 

3  “  green 

4  -  yellow 


5  -  blue 

6  ■  purple 

7  -  turquoise 

8  -  white 


System- Language: 

ADVISAR-FTN4 

Routines  Used: 

RSCOM 


r 


***black-white  key: 


0  ■  flashing 

1  -  black  on  both  monitors 

2  -  black  on  first,  white  on  second 

3  •  white  on  first,  black  on  second 

4  ■  white  on  both 
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SUBROUTINE  RDISP 


Purpose: 


To  read  the  display  parameter  associated  with  each  signal  system. 


DIMENSION  ISS  (5) 

CALL  RDISP  (ISS) 

Where:  ISS  "  array  containing  display  parameters  returned 

And:  ISS(I)  _>  0;  value  is  frame  currently  being  displayed  on  that 

signal  system  (0-7) 

ISS(I)  <  0;  indicates  that  the  signal  system  is  off 


Author: 


M.  Brown 


System- Language: 

ADVISAR  -  FTN4 
Routines  Used: 


I  AND,  RSCOM 
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SUBROUTINE  RJOY1 


Purpose : 


To  read  the  current  position  of  joystick  one. 


CALL  RJOYi  (IX,  IY) 

Where:  IX  -  X  position  of  joystick  one  returned  (0-511) 
IY  -  Y  position  of  joystick  one  returned  (0-511) 


Author  - 


M.  Brown 


Sys  ten- Language : 


ADVISAR-FTN4 

Routines  Used: 

RSCOM 
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SUBROUTINE  RJOY2 


Purpose : 


To  read  Che  current  position  of  joystick  two. 


Usage : 


CALL  RJ0Y2  (IX,  IY) 

Where:  IX  -  X  position  of  joystick  two  returned 
IY  »  Y  position  of  joystick  two  returned 


Author: 


M.  Brown 


System- Language : 

ADVISAR-FTN4 


(0-511) 

(0-511) 


Routines  Used: 

RSCOM 
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I 

i 


SUBROUTINE  RLOOP 


Purpose:  To  rea(j  the  iOQp  parameters  associated  with  a  signal  system. 


Usage : 

DIMENSION  LOOP  (12) 


CALL  RLOOP  (ISS,  LOOP) 

Where:  ISS  -  signal  system  (0-4) 

LOOP  ■  array  containing  loop  parameters  returned  as  follows: 
LOOP(l)  »  loop  key* 

(2)  -  loop  frame  count  (1-8) 

(3)  “  loop  rate  (>1;  #  of  frame  interrupts) 

(4)  ■  loop  first  frame  dwell(^l;  it  of  frame  interrupts) 

(5)  ■  first  frame  in  loop  (0-7) 

(6)  -  second  frame  in  loop (0-7) 


(12)  ••  last  frame  in  loop 


*  loop  key 


Author: 

M.  Brown 

Sy  s  t  em-Language : 

ADVISAR  -  FTN4 


-3  reset 
-2  back 
-1  advance 
0  hold 
1  loop 


Routines  Used: 

MOD,  RSCOM 
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SUBROUTINE  ROURL 


Purpose:  jq  read  the  number  of  overlays  and  the  overlay  frames  associated 
with  a  signal  system. 


Usage:  DIMENSION  I0VS(3) 


CALL  ROURL  (ISS,  N,  IOVS) 


Where:  ISS  »  signal  system  (0-4) 

N  »  number  of  overlays  returned  (0-3) 

IOVS  "  array  containing  overlay  frame  numbers  returned 


Author:  jj.  Brown 

System- Language: 

ADVISAR,  FTN4 

Routines  Used: 

MOD,  IAND,  ISHFT,  RSCOM 
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SUBROUTINE  RPOTS 


Purpose:  To  read  the  outpuC  0f  the  joystick  potentiometers. 


Usage: 


DIMENSION  IPOTS  (4) 

CALL  RPOTS  (IPOTS) 

Where:  IPOTS  “  array  of  outputs  from  potentiometers  1-4  returned 
(0-2047) 


Author:  M  Brown 

Sys  t  em- Language : 

ADVISAR  -  FTN4 


Routines  Used: 

RSCOM 
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SUBROUTINE  RSCRN 


Purpose : 


To  read  che  current  image  area  on  Che  screen 


Usage : 

CALL  RSCRN  (IBX,  IEX,  IBY,  IEY) 

Where:  IBX  "  beginning  X  screen  coordinate 
IEX  ”  ending  X  screen  coordinate 
IBY  «*  beginning  Y  screen  coordinate 
IEY  *  ending  Y  screen  coordinate 


Author: 

Marvin  Brown 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

RSCOM 


i 

: 
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SUBROUTINE  RVIDO 


Purpose: 


To  read  the  video  system  key 


Usage: 


CALL  RVIDO  (IVIDO) 


Where:  IVIDO  -  video  system  key  returned  (0-1) 
0  *  512  positions 
1  -  480  positions 


Author: 


M.  Brown 


System- Language: 

ADVISAR  -  FTN4 
Routines  Used: 


I  AND,  RSCOM 
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SUBROUTINE  VCT 


Purpose : 


to  draw  a  vector  on  a  frame  in  the  memories. 


Usage;  CAljIj  VCT  (IX,  IY) 

Where  IX  »  integer  X  location  of  end  point 
IY  *»  integer  Y  location  of  end  point 

Note:  A  line  is  drawn  from  the  old  plotting  pointer  position  to 

(IX,  IY).  The  pointer  ia  set  to  (IX,  IY) .  The  liup  1$  jir^wp. 
with  width,  dash  pattern  and  value  as  specified  by  other 
routines. 


Author: 


Mark  Whitcomb 


System- Language: 


ADVISAR  -  FTN4 
Routines  Used: 

RPCOM,  an  entry  point  in  PCOM 
LINE 
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SUBROUTINE  VCTR 


Purpose: 


To  draw  a  vector  to  a  frame  In  the  memories,  using  relative  coordinates. 


CALL  VCTR  (IX,  IY) 

Where:  IX  -  integer  X  increment 
IY  ”  Integer  Y  increment 

Note:  A  line  is  drawn  from  the  old  plotting  pointer  to  the  location 

of  the  older  pointer  plus  (IX,  IY).  The  pointer  is  then  set 
to  its  old  value  plus  (IX,  IY). 

The  line  is  drawn  with  width,  value  and  dash  pattern  as  set 
by  other  routines. 


Author: 


Mark  Whitcomb 


System- Language: 


ADVISAR  -  FTN4 
Routines  Used: 

RPCOM,  an  entry  point  in  PCOM 
LINE 
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SUBROUTINE  WAITS 


Purpose : 


To  suspend  a  program  for  a  given  number  of  video  retraces. 


Usage:  CALL  WAITS  (N) 

Where:  N  >  0  then  the  program  is  suspended  for  N/30  seconds. 

<  0  then  the  program  is  suspended  for  -N/60  seconds. 

"  0  then  the  program  is  suspended  until  f  i  next  video 

retrace. 


Author: 


Marvin  Brown 


System- Language: 

ADVISAR  -  ASMB 

Routines  Used: 

: ENTR,  RNRQ,  .WWAT 


SUBROUTINE  WCUSP 


Purpose: 


To  write  out  the  desired  cursor  position. 


CALL  WCURP  (IX,  IY) 

Where:  IX  -  desired  X  position  of  cursor  center  (0-511) 
IY  ■  desired  Y  position  of  cursor  center  (0-511) 


Author: 

M.  Brown 

System- Language : 

ADVISAR  -  FTN4 
Routines  Used: 


WSCOM,  WAITS 
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SUBROUTINE  WCURS 


Purpose: 


To  write  out  the  desired  cursor  dimensions. 


Usage : 


CALL  WCURS  (IXD,  IYD)* 


Where:  IXD  ■  desired  X  dimension  of  cursor  size  (0-511) 

IYD  •  desired  Y  dimension  of  cursor  size  (0-511) 

*Note:  The  cursor  will  be  turned  off  following  execution  of  tljis 
routine. 


Author : 


M.  Brown 


System- Language: 

ADVISAR  -  FTN4 
Routines  Used: 


WSCOM,  WAITS 
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SUBROUTINE  WCURT 


Purpose : 


To  write  out  the  desired  cursor  type  and  color  parameters. 


Usage: 


CALL  WCURT  (ITYPE,  ICOLR,  IBW) 


Where:  ITYPE  -  cursor  type  *  (0-8) 

ICOLR  “  cursor  color  **  (0-8) 

IBW  ■  black-white  cursor  key  ***  (0-4) 


*  cursor  types: 


**cursor  colors: 


(more  on  back) 

Author : 


M.  BROWN 

System- Language: 

ADVISAR-FTN4 


0  °  no  cursor 

1  »  solid  box 

2  ■  box  outline 

3  “  window 

4  •  window  with 

5  *  cross  hairs 

6  ■  four  corner 

7  ■  window  with 

8  -  window  with 

0  ■  flashing 

1  ”  black 

2  ■  red 

3  •  green 

4  »  yellow 


box 

dots 

cross-hairs 
four  corner  dots 

5  -  blue 

6  »  purple 

7  ■  turquoise 

8  ■  white 


Routines  Used: 

WSCOM 


1 


***  black-white  key: 


0  “  flashing 

1  ■  black  on  both  monitors 

2  -  black  on  first,  white  on  second 

3  »  white  on  first,  black  on  second 

4  *  white  on  both 
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SUBROUTINE  WDISP 


Purpose.  jQ  wr^te  (-jjg  £rame  number  to  be  displayed  on  each  signal  system, 
optionally  to  turn  the  signal  system  on  or  off. 


Usage : 


DIMENSION  ISS  (5) 


CALL  WDISP  (ISS) 

Where  ISS  =  array  containing  frame  numbers  to  be  displayed  on  each 
signal  system  (0-7) 

And  ISS(I)  _>  0;  value  is  frame  number  to  be  displayed,  signal  system 
should  be  turned  on 

ISS(I)  <  0;  turn  the  signal  system  off 


Author : 

M.  Brown 
System- Language: 

ADVISAR  -  FTN4 
Routines  Used: 

RSCOM,  I AND,  I0R,  WSCOM 


** . 
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SUBROUTINE  WDTH 


Purpose:  jo  get  t^e  width  for  lines  Co  be  drawn. 


Usage : 

CALL  WDTH  (IW) 

Where:  IW  »  integer  width  of  line  (in  points  of  a  horizontal  or 
vertical  line) 


Author : 

Mark  Whitcomb 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

WPCOM,  an  entry  point  in  PCOM 
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SUBROUTINE  WLOOP 


Purpose : 


To  write  the  loop  parameters  for  a  signal  system. 


Usage : 


DIMENSION  LOOP  (12) 


CALL  WLOOP  (ISS,  LOOP) 


Where:  ISS  -  signal  system  (0-4) 

LOOP  ■  array  containing  loop  parameters  to  write 


LOOP  (1) 

(2) 

(3) 

(4) 

(5) 

(6) 


loop  key* 

loop  frame  count  (1-8) 

loop  rate  (>1;  #  of  frame  interrupts) 

loop  first  frame  dwell  (>1;  it  of  frame  interrupts) 

first  frame  in  loop  (0-7) 

second  frame  in  loop  (0-7) 


* 


(12)- 

loop  key 


Author: 

M.  Brown 


last  frame  in  loop 

-  -3  reset 

-  -2  back 

-  -1  advance 

-  0  hold 

-  1  loop 


System- Language : 

ADVISAR  -  FTN4 


Routines  Used: 

MOD,  WSCOM 
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SUBROUTINE  WSCRN 


Purpose:  Xo  set  the  current  image  area  on  the  screen. 


Usage : 

CALL  WSCRN  (IBX,  IEX,  IBY,  IEY) 

Where  -  IBX  »  beginning  X  screen  coordinate 
IEX  -  ending  X  screen  coordinate 
IBY  «  beginning  Y  screen  coordinate 
IEY  »  ending  Y  screen  coordinate 


Author : 

Marvin  Brown 

System- Language: 

ADVISAR  -  FTN4 

Routines  Used: 

RSCOM 
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SUBROUTINE  WVIDO 


Purpose:  To  write  out  the  desired  video  system  key 


Usage : 

CALL  WVIOO  (IVIDO) 

Where:  IVIDO  **  video  system  key  (0-1) 
0  *  512  positions 
1  -  480  positions 


Author: 

M.  Brown 

System-Language: 

ADVISAR-FTN4 


Routines  Used: 

RVIDO,  I AND)  WAITS,  WSCOM 
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Appendix  K 

List  of  participating  scientific  personnel  and  advanced  degrees 
earned: 

Marvin  Brown 

Thomas  Brubaker 

Robert  Fitch  —  MS  in  Electrical  Engineering 
Uwe  Haas 

Kenneth  R.  Morris 
Andrew  Negri 
David  Reynolds 

Eric  Smith  —  MS  in  Atmospheric  Science 
Gregory  Smith  —  MS  in  Electrical  Engineering 
Richard  Stodt 
Thomas  VonderHaar 
Mark  Whitcomb 


